home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / COMMUNIC / BULLETIN / 0340A.ZIP / ODOC_000.ARC / OPUS_SYS.DOC next >
Text File  |  1987-01-05  |  153KB  |  3,528 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.                      ############                              
  14.                      ##        ##                              
  15.                      ##        ##                              
  16.                      ##        ##  ########  ##     ##  #######
  17.                      ##        ##  ##    ##  ##     ##  ##     
  18.                      ##        ##  ##    ##  ##     ##  #######
  19.                      ##        ##  ##    ##  ##     ##       ##
  20.                      ############  ########  #########  #######
  21.                                    ##                          
  22.                                    ##                          
  23.                                    ##                          
  24.                                    ##                          
  25.  
  26.  
  27.  
  28.  
  29.  
  30.                          ----------------------------------
  31.                          Computer-Based Conversation System
  32.                                  by Wynn Wagner III
  33.                                    Matrix 124/108
  34.                          ----------------------------------
  35.  
  36.  
  37.  
  38.  
  39.  
  40.                    Questions regarding Opus should be directed to:
  41.  
  42.                     OPUSinfo Here     modem (214) 991-3381 1/113
  43.                     OPUSinfo There    modem (415) 753-3356 1/114
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.                  OPUS - Copyright (c) 1986, 1987 by Wynn Wagner III
  54.                                  All rights reserved
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.           OPUS is  militantly public  domain. This  means you  may NOT sell
  64.           OPUS or any part of it to anybody for any reason.If you  do, then
  65.           you are required to make a contribution of $50 to:
  66.  
  67.                                  The Shanti Project
  68.                                   896 Hayes Street
  69.                                San Francisco, CA 94117
  70.                             Attn: Director of Development
  71.  
  72.                Please   mention   that   your  contribution  is  for  OPUS.
  73.           Hopefully, the  contribution will  be tax-deductible  -- you will
  74.           receive an acknowledgement directly from The Shanti Project.
  75.  
  76.  
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.                     "It  was  the  Law  of  the  Sea,  they said.
  87.                     Civilization ends  at  the  waterline. Beyond
  88.                     that, we  all enter  the food  chain, and not
  89.                     always right at the top."
  90.                                         --- Hunter S. Thompson
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.           Documentation by David Finster, Mike Kelleher,  Mike Elkins, Wynn
  100.           Wagner, and Jon Sabol.
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.                                   TABLE OF CONTENTS
  116.  
  117.           INTRODUCTION
  118.  
  119.                What's an "OPUS?" . . . . . . . . . . . . . . . . . . .    1
  120.                About This Document . . . . . . . . . . . . . . . . . .    1
  121.                What does OPUS really mean? . . . . . . . . . . . . . .    2
  122.                The Rules for Using OPUS  . . . . . . . . . . . . . . .    2
  123.                The Rules on Transferring OPUS Software . . . . . . . .    2
  124.                List of Things Borrowed, not Blue . . . . . . . . . . .    3
  125.                Legal Stuff . . . . . . . . . . . . . . . . . . . . . .    3
  126.                Version Numbers . . . . . . . . . . . . . . . . . . . .    4
  127.  
  128.           OVERVIEW
  129.  
  130.                Equipment . . . . . . . . . . . . . . . . . . . . . . .    5
  131.                     Hardware . . . . . . . . . . . . . . . . . . . . .    5
  132.                     Software . . . . . . . . . . . . . . . . . . . . .    5
  133.                          CONFIG.SYS File . . . . . . . . . . . . . . .    6
  134.                               FILES=xx . . . . . . . . . . . . . . . .    6
  135.                               BUFFERS=xx . . . . . . . . . . . . . . .    6
  136.                               COUNTRY=xxx  . . . . . . . . . . . . . .    6
  137.                               DEVICE=ANSI.SYS  . . . . . . . . . . . .    7
  138.                          AUTOEXEC.BAT  . . . . . . . . . . . . . . . .    7
  139.                               OPUS!Comm  . . . . . . . . . . . . . . .    7
  140.                               Set TZ=  . . . . . . . . . . . . . . . .    8
  141.                Functional Overview . . . . . . . . . . . . . . . . . .    9
  142.                     The Matrix . . . . . . . . . . . . . . . . . . . .    9
  143.                     Messages . . . . . . . . . . . . . . . . . . . . .    9
  144.                          Local Messages  . . . . . . . . . . . . . . .    9
  145.                          Matrix Messages . . . . . . . . . . . . . . .    9
  146.                          Broadcast Messages  . . . . . . . . . . . . .   10
  147.                     File Section . . . . . . . . . . . . . . . . . . .   10
  148.                          Uploads . . . . . . . . . . . . . . . . . . .   10
  149.                          Downloads . . . . . . . . . . . . . . . . . .   10
  150.                          Matrix  . . . . . . . . . . . . . . . . . . .   10
  151.                Operating Philosophy  . . . . . . . . . . . . . . . . .   11
  152.                Differences Between OPUS and FIDO<tm> . . . . . . . . .   11
  153.                     File Structures  . . . . . . . . . . . . . . . . .   11
  154.                     Extended Display File Capability . . . . . . . . .   12
  155.                     Extended File Transfer Protocols . . . . . . . . .   13
  156.                     EchoMail Enhancements  . . . . . . . . . . . . . .   13
  157.                     Mail Interface . . . . . . . . . . . . . . . . . .   13
  158.                     Extended Message Area Attributes . . . . . . . . .   14
  159.                     Message Area Commands  . . . . . . . . . . . . . .   14
  160.                     File Area Commands . . . . . . . . . . . . . . . .   15
  161.                     Miscellaneous Commands . . . . . . . . . . . . . .   16
  162.  
  163.  
  164.                              OPUS Sysop Manual - Page i
  165.  
  166.  
  167.  
  168.  
  169.  
  170.           THE MESSAGE SECTION
  171.  
  172.                What is a Message Section?  . . . . . . . . . . . . . .   17
  173.                Setting up a Message Section  . . . . . . . . . . . . .   17
  174.                     System Files   . . . . . . . . . . . . . . . . . .   17
  175.                          Creating a System File  . . . . . . . . . . .   17
  176.                          Privilege . . . . . . . . . . . . . . . . . .   18
  177.                          Setting Paths . . . . . . . . . . . . . . . .   18
  178.                               BBS Path . . . . . . . . . . . . . . . .   18
  179.                               Help Path  . . . . . . . . . . . . . . .   19
  180.                               Message Path   . . . . . . . . . . . . .   19
  181.                               File Path  . . . . . . . . . . . . . . .   19
  182.                          Titles  . . . . . . . . . . . . . . . . . . .   19
  183.                     Area Types   . . . . . . . . . . . . . . . . . . .   20
  184.                          Local   . . . . . . . . . . . . . . . . . . .   20
  185.                          Matrix  . . . . . . . . . . . . . . . . . . .   20
  186.                          EchoMail  . . . . . . . . . . . . . . . . . .   20
  187.                     Area Aspects . . . . . . . . . . . . . . . . . . .   21
  188.                          Privilege Levels  . . . . . . . . . . . . . .   21
  189.                          Public-Only . . . . . . . . . . . . . . . . .   21
  190.                          Private-Only  . . . . . . . . . . . . . . . .   21
  191.                          Public-or-Private . . . . . . . . . . . . . .   21
  192.                          Read-Only . . . . . . . . . . . . . . . . . .   21
  193.                          Anonymous-OK  . . . . . . . . . . . . . . . .   22
  194.                Special Considerations for Matrix Messages  . . . . . .   22
  195.                     NetInfo  . . . . . . . . . . . . . . . . . . . . .   22
  196.                     OPUSnode . . . . . . . . . . . . . . . . . . . . .   22
  197.                     Cost Accounting  . . . . . . . . . . . . . . . . .   22
  198.                     Handling Crashmail . . . . . . . . . . . . . . . .   23
  199.                          Refuse Crashmail  . . . . . . . . . . . . . .   23
  200.                          After Crashmail Exit  . . . . . . . . . . . .   23
  201.                          IFNA<tm> Kludge . . . . . . . . . . . . . . .   23
  202.                          Extract ARCmail . . . . . . . . . . . . . . .   24
  203.                          After ARCmail Exit  . . . . . . . . . . . . .   24
  204.                     Default Settings . . . . . . . . . . . . . . . . .   24
  205.                          MATRIX Assume vs. MATRIX Ask  . . . . . . . .   24
  206.                               Kill/Sent  . . . . . . . . . . . . . . .   25
  207.                               File Attach  . . . . . . . . . . . . . .   25
  208.                               WARNING!!! . . . . . . . . . . . . . . .   25
  209.                               Crashmail  . . . . . . . . . . . . . . .   25
  210.                               File Request . . . . . . . . . . . . . .   25
  211.                               Update Request . . . . . . . . . . . . .   26
  212.                               Return Receipts  . . . . . . . . . . . .   26
  213.                               Audit Trail  . . . . . . . . . . . . . .   26
  214.                Special Considerations for EchoMail . . . . . . . . . .   26
  215.                     Configuration Note . . . . . . . . . . . . . . . .   26
  216.                     Areas.Bbs  . . . . . . . . . . . . . . . . . . . .   26
  217.                     Origin Line  . . . . . . . . . . . . . . . . . . .   27
  218.                     Automatic Toss . . . . . . . . . . . . . . . . . .   27
  219.                     Seenby Displays  . . . . . . . . . . . . . . . . .   27
  220.                     Processing Outbound EchoMail . . . . . . . . . . .   27
  221.  
  222.  
  223.                              OPUS Sysop Manual - Page ii
  224.  
  225.  
  226.  
  227.  
  228.  
  229.                Enhanced Message Area Commands  . . . . . . . . . . . .   28
  230.                     The Hurl Command . . . . . . . . . . . . . . . . .   28
  231.                     The Forward Command  . . . . . . . . . . . . . . .   28
  232.                     Forward With Bombing Run . . . . . . . . . . . . .   28
  233.                     The Zone Command . . . . . . . . . . . . . . . . .   29
  234.                Special Message Areas . . . . . . . . . . . . . . . . .   30
  235.                     Hidden Areas . . . . . . . . . . . . . . . . . . .   30
  236.                     Barricaded Areas . . . . . . . . . . . . . . . . .   30
  237.                Hints, Tricks, and Sleight of Hand  . . . . . . . . . .   32
  238.                     Directory Sorts  . . . . . . . . . . . . . . . . .   32
  239.                     Renumbering Message Areas  . . . . . . . . . . . .   32
  240.                     Disk Optimizing  . . . . . . . . . . . . . . . . .   33
  241.  
  242.           THE FILE SECTION
  243.  
  244.                What is a File Section? . . . . . . . . . . . . . . . .   35
  245.                Configuring a File Area . . . . . . . . . . . . . . . .   35
  246.                     Upload Path  . . . . . . . . . . . . . . . . . . .   35
  247.                     Download Path  . . . . . . . . . . . . . . . . . .   35
  248.                     Titles . . . . . . . . . . . . . . . . . . . . . .   35
  249.                Files.Bbs . . . . . . . . . . . . . . . . . . . . . . .   35
  250.                     Comments . . . . . . . . . . . . . . . . . . . . .   36
  251.                     End-of-List Character  . . . . . . . . . . . . . .   36
  252.                     Wildcards  . . . . . . . . . . . . . . . . . . . .   36
  253.                     Handling Dates . . . . . . . . . . . . . . . . . .   36
  254.                Quirks, Peculiarities, and Caveats  . . . . . . . . . .   37
  255.                External File Transfer Programs . . . . . . . . . . . .   37
  256.                     Sliding Window Kermit  . . . . . . . . . . . . . .   38
  257.                     Windowed Xmodem  . . . . . . . . . . . . . . . . .   38
  258.  
  259.           OPUS SYSOP SUPPORT
  260.                Installing OPUS Software  . . . . . . . . . . . . . . .   39
  261.                The Control File  . . . . . . . . . . . . . . . . . . .   39
  262.                The Control File Compiler . . . . . . . . . . . . . . .   39
  263.                Command Line Options  . . . . . . . . . . . . . . . . .   39
  264.                     Parameter File . . . . . . . . . . . . . . . . . .   40
  265.                     Baud Rate  . . . . . . . . . . . . . . . . . . . .   40
  266.                     Time . . . . . . . . . . . . . . . . . . . . . . .   40
  267.                     Port . . . . . . . . . . . . . . . . . . . . . . .   40
  268.                     Unpack Mail  . . . . . . . . . . . . . . . . . . .   40
  269.                The Sysop Menu ("!")  . . . . . . . . . . . . . . . . .   40
  270.                     A)rea Maintenance  . . . . . . . . . . . . . . . .   41
  271.                     D)elete Messages . . . . . . . . . . . . . . . . .   41
  272.                     M)atrix Setup  . . . . . . . . . . . . . . . . . .   41
  273.                     E)vent Manager . . . . . . . . . . . . . . . . . .   42
  274.                     O)utside Command . . . . . . . . . . . . . . . . .   42
  275.                Events  . . . . . . . . . . . . . . . . . . . . . . . .   43
  276.                Embedded Commands . . . . . . . . . . . . . . . . . . .   43
  277.                User Access Levels  . . . . . . . . . . . . . . . . . .   43
  278.                Sysop's Keyboard  . . . . . . . . . . . . . . . . . . .   43
  279.  
  280.  
  281.  
  282.                             OPUS Sysop Manual - Page iii
  283.  
  284.  
  285.  
  286.  
  287.  
  288.           APPENDICES
  289.  
  290.                OPUS Program and Support File List  . . . . . . . . . .   44
  291.                Embedded Commands . . . . . . . . . . . . . . . . . . .   46
  292.                For More information on OPUS  . . . . . . . . . . . . .   54
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.                              OPUS Sysop Manual - Page iv
  342.  
  343.  
  344.  
  345.  
  346.  
  347.                                     INTRODUCTION
  348.  
  349.           What's an "OPUS?"
  350.  
  351.                OPUS  is  a  computer-based  conversation system (CBCS) that
  352.                started with a conversation containing lines  such as: "Gee,
  353.                wouldn't it be nice if..." That was in December of 1985, and
  354.                the current program reflects much in the way of enhancements
  355.                to existing <tm> bulletin board systems. 
  356.  
  357.                OPUS  incorporates   extensive  messaging  and  conferencing
  358.                capabilities along with  a  sophisticated  software exchange
  359.                system  to   create  a   fully  interactive,  user-friendly,
  360.                bulletin board system.
  361.  
  362.                You'll find that OPUS is compatible with MOST of the support
  363.                file structures  used by  FIDO<tm> version 11w. OPUS is also
  364.                capable  of  receiving  incoming  Matrix  traffic.  This  is
  365.                compatible  with  FIDOnet<tm>  network  protocols, including
  366.                SEAlink<tm>, a fast, full-duplex transfer protocol.
  367.  
  368.           About This Document
  369.  
  370.                This manual is  supplied  for  reference  to  the  sysop. It
  371.                assumes you  have already  installed OPUS, and it is running
  372.                properly. You will find many  of  the  "bells  and whistles"
  373.                OPUS has  described here, although you won't find out how to
  374.                install it, or how to generate outgoing calls.  These things
  375.                are best discussed in a separate document. 
  376.  
  377.                You should  have received  an installation program that will
  378.                setup a basic OPUS. It pretty  well covers  all the dynamics
  379.                of creating  paths, and putting files in the right place. If
  380.                you are a new sysop, you probably will want to  run with the
  381.                basic OPUS  for a  few weeks  until you get comfortable with
  382.                the OPUS method  of  operation.  Once  you  understand which
  383.                files do what, you should be ready to custom tailor OPUS for
  384.                your interests and desires. When you initially install OPUS,
  385.                you should  keep it  simple. Let  OPUS do the work. It knows
  386.                what  it  needs  and  where,  and  you  can  run  into  very
  387.                perplexing problems  if don't  put things where they belong.
  388.                You can  always modify  the system  at a  later date without
  389.                reinstalling the software.
  390.  
  391.                There is also a file called 'OPUSER.DOC'. This is the user's
  392.                guide to OPUS. It tells you  what  OPUS  looks  like  from a
  393.                user's  point   of  view.  This  will  aid  you  greatly  in
  394.                determining what features are available from what menus.
  395.  
  396.  
  397.  
  398.  
  399.  
  400.                              OPUS Sysop Manual - Page 1
  401.  
  402.  
  403.  
  404.  
  405.  
  406.           What does OPUS really mean?
  407.  
  408.                The word "opus" is Latin  and  means  "project".  Most folks
  409.                think  that  OPUS  is  an  alcoholic  penguin from the comic
  410.                strips. To tell you the truth, the guy who designed  most of
  411.                the OPUS  CBCS hadn't  read the  comics in  years; he had no
  412.                idea why ANSI drawings  of a  rather perplexed  bird started
  413.                appearing on OPUS opening screens.
  414.  
  415.                We mention this for two reasons:
  416.  
  417.                First, it  underscores the  philosophy behind  OPUS. OPUS is
  418.                free, with no personal profit involved.  We make  no attempt
  419.                to control  OPUS' use  or to  alter what you think about the
  420.                software, the matrix, or the  state  of  the  union.  If you
  421.                think OPUS  is a penguin, we think that's just fine. OPUS is
  422.                a tool for hobbyists, and should always be used for fun, not
  423.                profit, or gain.
  424.  
  425.                Second, if  you mention  "foul" to any of us, we'll probably
  426.                think you mean a bug in the program, not a  pitiable bird in
  427.                a tux.
  428.  
  429.                It may  be a  bird to  you --  and that's  okay. We know one
  430.                thing for sure, in most cases,  it's faster  than a speeding
  431.                bullet!
  432.  
  433.           The Rules for Using OPUS
  434.  
  435.                You have  only two  obligations if  you want to use the OPUS
  436.                system:
  437.  
  438.                     1. Be friendly about it. Don't start hollerin' at other
  439.                        OPUS Sysops  or at its creators or one of our Help  
  440.                     Nodes. OPUS is user-friendly  software. You  have to   
  441.                     be friendly to use it.
  442.  
  443.                     2. Don't use OPUS to break laws.
  444.  
  445.           The Rules on Transferring OPUS Software
  446.  
  447.                You  are  specifically  forbidden,  under  the terms of your
  448.                limited license, to make money  from  the  transfer  of OPUS
  449.                software. OPUS software must always be free.
  450.  
  451.                If your  board charges a fee to users, then you may NOT keep
  452.                OPUS software on-line for  download. You  can run  OPUS, but
  453.                you cannot distribute it because you charge money.
  454.  
  455.                You  cannot  "bundle"  OPUS  software with any other product
  456.                when there is a fee for that product.
  457.  
  458.  
  459.                              OPUS Sysop Manual - Page 2
  460.  
  461.  
  462.  
  463.  
  464.  
  465.                User  groups   and   other   non-profit   organizations  can
  466.                distribute  OPUS  software  on  such  things as "Disk of the
  467.                Month", as long as there  is  no  charge  over-and-above the
  468.                actual cost of the distribution diskette.
  469.  
  470.                If you  paid money for your copy of OPUS, please contact one
  471.                of the OPUSinfo systems. We want to know about it.
  472.  
  473.           List of Things Borrowed, not Blue
  474.  
  475.                We'd like to thank Ward  Christiansen,  who  thought  up the
  476.                whole idea  of bulletin  boards and without who we would not
  477.                electronic communications today. We also would like to thank
  478.                Chuck Forsberg, who has done more for file transfer protocol
  479.                improvements than any other single person.
  480.  
  481.                A special thanks to  the folks  at Columbia  University, for
  482.                their fine specification of sliding window Super-Kermit, and
  483.                Jan A. van der Eyk, for  his implementation  of the protocol
  484.                in CKERMIT.
  485.  
  486.                The current  structure of  OPUS owes  a debt of gratitude to
  487.                Tom  Jennings,  whose  FIDO<tm>   software  and  FIDONet<tm>
  488.                network protocol provided much ancestral inspiration.
  489.  
  490.                CRC Routines.  These were pillaged from a bulletin board. We
  491.                found no name on  the routines,  but we  need to  say thanks
  492.                anyway.
  493.  
  494.                Widgets, such  as the  ability to display the contents of an
  495.                archive while online, were suggested by one of  many sysops,
  496.                without whom there there'd be no need for you to read this.
  497.  
  498.                System Enhancements  Associates designed  ARChive files, the
  499.                SEALink file transfer protocol, and ARCMail.
  500.  
  501.                Bob Hartman created the communications driver OPUS!Comm, and
  502.                did a great deal of the file transfer code.
  503.  
  504.                Jeff Rush designed EchoMail.
  505.  
  506.           Legal Stuff
  507.  
  508.                The SEALink  file transfer protocol is copyrighted by System
  509.                Enhancements Associates, who decided  not to  charge for its
  510.                use  if  proper  credit  was given. We're giving that credit
  511.                now, and there is a brief  copyright notice  on the protocol
  512.                menu.
  513.  
  514.                OPUS!Comm is copyrighted by Sparks Software, and is licensed
  515.                for use on this project.
  516.  
  517.  
  518.                              OPUS Sysop Manual - Page 3
  519.  
  520.  
  521.  
  522.  
  523.  
  524.           Version Numbers
  525.  
  526.                Copies of OPUS always have at least numbers:
  527.  
  528.                                         1.00
  529.  
  530.                A major revision number  change (such  as from  a 1.00  to a
  531.                2.00)  is  a  serious  change,  and  normally  involves some
  532.                structure incompatibility between the old and  new versions.
  533.                A  conversion  utility  will  be  provided if possible. This
  534.                would be something like changing the user file format from a
  535.                FIDO<tm> compatible file to something a little more flexible
  536.                and more suited to OPUS' abilities.
  537.  
  538.                On the other hand, a change from 1.00  to 1.10,  isn't quite
  539.                as drastic.  Usually this  will reflect  the addition of new
  540.                features that don't involve any major configuration changes.
  541.                An  example  would  be  adding  an  additional file transfer
  542.                protocol,  or  enhanced  search  functions  in  the  message
  543.                section.
  544.  
  545.                Finally,  a  move  from  1.00  to 1.01 would be a very minor
  546.                change. Maybe changing the wording in  a section  of text or
  547.                something.
  548.  
  549.  
  550.  
  551.  
  552.  
  553.  
  554.  
  555.           And now, back to the regular BBS...
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.  
  564.  
  565.  
  566.  
  567.  
  568.  
  569.  
  570.  
  571.  
  572.  
  573.  
  574.  
  575.  
  576.  
  577.                              OPUS Sysop Manual - Page 4
  578.  
  579.  
  580.  
  581.  
  582.  
  583.                                       OVERVIEW
  584.  
  585.           Equipment
  586.  
  587.           Hardware
  588.  
  589.                Currently, Opus runs on an IBM-Compatible computer, or a DEC
  590.                Rainbow with at least 128k of  memory free.  This means that
  591.                you should  have at least 256k so that OPUS will have enough
  592.                memory after DOS and the  driver  programs  are  loaded. The
  593.                difference  between  the  IBM  and  the DEC versions, is the
  594.                OPUS!Comm driver used. As of  this  writing,  these  are the
  595.                only two drivers available. However, the specs for OPUS!Comm
  596.                are public, and anyone  who cares  to can  write drivers for
  597.                other MS-DOS machine. For details, contact Sparks Software. 
  598.  
  599.                Also, OPUS  REQUIRES a  storage device  larger than a floppy
  600.                drive. Generally, this will be  a  hard  drive,  but  can be
  601.                cartridge  media  such  as  a Bournoulli Box just as easily.
  602.                There are absolutely no plans to release a version that will
  603.                run  on  floppies;  the  support  files simply take too much
  604.                room.
  605.  
  606.                Theoretically, OPUS will use any modem  that uses  the Hayes
  607.                command  set  and  supports  DTR.  It  has been successfully
  608.                tested with the USR  Courier, and  the Hayes  family. If you
  609.                use  another  modem  type,  OPUS  should  work,  but  is not
  610.                guaranteed. If you get other brands  of modems  to work with
  611.                OPUS, please  contact one of the INFOnodes and let them know
  612.                the brand name and what you had to do to get it to work.
  613.  
  614.           Software
  615.  
  616.                Several pieces of software  are  required  to  make  an OPUS
  617.                work. You  must have DOS 2.1 or greater. OPUS will run under
  618.                DOS 2.1, but some of the features will not work. DOS 2.0 and
  619.                1.1 are  NOT supported.  DOS 3.1  is recommended for a fully
  620.                featured OPUS system.
  621.  
  622.                You will also need  to install  the ANSI  device driver that
  623.                comes with  DOS (this is built into DEC's version of DOS) in
  624.                order to use the graphics capabilities of OPUS.  ANSI allows
  625.                your computer to send escape codes to the remote computer to
  626.                tell it things like colors and  cursor positioning.  You can
  627.                install  ANSI  by  copying  the  file  ANSI.SYS  to the root
  628.                directory of the drive your computer boots off of and adding
  629.                a line in Config.sys that reads:
  630.                          device=ANSI.SYS
  631.                This will  install the necessary driver to allow OPUS to use
  632.                graphics. If you see a lot of numbers,semi-colons,  and left
  633.                square  brackets  when  OPUS  runs,  you  do  not  have ANSI
  634.                installed.
  635.  
  636.                              OPUS Sysop Manual - Page 5
  637.  
  638.  
  639.  
  640.  
  641.  
  642.           CONFIG.SYS File
  643.  
  644.  
  645.                While we're on the subject of  Config.sys, we  might need to
  646.                say a few more things about it. Config.sys allows you to set
  647.                some of the operating  parameters of  your computer  at boot
  648.                time.  There  are  three  main commands that directly affect
  649.                OPUS' performance:
  650.  
  651.                     1. FILES=xx
  652.                          This statement tells DOS  how many  files a single
  653.                          process may  have open  at one  time. If a program
  654.                          tries  to  use  more  files  than  DOS  allows, it
  655.                          generally  does  real  nasty things; like deleting
  656.                          the currently  opened files  to make  room for new
  657.                          files.  Not   a  pretty  sight.  OPUS  requires  a
  658.                          parameter  greater  than  or  equal  to   20.  DOS
  659.                          allocates  48  bytes  for  each  file  defined  in
  660.                          Config.sys,  So  you  can  be  pretty  liberal  in
  661.                          allocating these.  If you are running some sort of
  662.                          multi-tasker, remember that your  file handles are
  663.                          divided by  the number  of tasks you have running.
  664.                          That is, if you are running two programs,  and you
  665.                          have files set to 20, each task will be allowed to
  666.                          open 10 files. This will not  work with  OPUS. You
  667.                          will need to increase the number of files defined.
  668.                          The  maximum  number  of  file  handles   you  can
  669.                          allocate is 255, but this is VERY excessive.
  670.  
  671.                     2. BUFFERS=xx
  672.                          This tells  DOS how much information to read in at
  673.                          a time when a  transfer is  made from  the disk to
  674.                          memory. Each  buffer takes 528 bytes, so you might
  675.                          need to watch this if you are running in a limited
  676.                          amount  of   space.  Generally  speaking,  if  you
  677.                          specify too few buffers  at  boot  time,  you will
  678.                          slow  the  system  down.  If  you specify too many
  679.                          buffers, you will slow  the  system  down,  so you
  680.                          really  need  to  experiment  with this one. We've
  681.                          found that a setting from 40 to 60  is about right
  682.                          on  most  systems.  The  largest number of buffers
  683.                          that can be allocated is 99.
  684.  
  685.                     3. COUNTRY=xxx
  686.                          This  parameter  specifies  how  the  keyboard  is
  687.                          mapped,   the   currency   symbol,   the   decimal
  688.                          separator, and most importantly, the date and time
  689.                          formats.
  690.  
  691.                               WARNING!!! OPUS  WILL DO  NASTY THINGS IF THE
  692.                               DATE FORMAT IS NOT AMERICAN!!!
  693.  
  694.  
  695.                              OPUS Sysop Manual - Page 6
  696.  
  697.  
  698.  
  699.  
  700.  
  701.                          You can still load  an  optional  keyboard driver,
  702.                          but you  cannot specify  a country code other than
  703.                          001. If you are  experiencing dates  showing up as
  704.                          garbage, you  have your  machine installed for the
  705.                          wrong country, even if you live there.
  706.  
  707.                     4. DEVICE=ANSI.SYS
  708.                          You must include this statement in  any Config.sys
  709.                          file that will be used when an OPUS CBCS system is
  710.                          used.  There   are  many   enhanced  ANSI  drivers
  711.                          available,  and  some  of  them  might  even work.
  712.                          However, ANSI.SYS is the  only currently supported
  713.                          driver.
  714.  
  715.  
  716.                     If you need help in setting up a Config.sys file, refer
  717.                     to  the  configuration  section  of  your  DOS  manual.
  718.                     Actually, there  is a  very good description in the DOS
  719.                     3.x manual and should more than answer any questions.
  720.  
  721.           AUTOEXEC.BAT
  722.  
  723.                OPUS also requires  a  couple  of  things  installed  in the
  724.                Autoexec.bat file  on your  system. This is usually the best
  725.                place to install  one-time  options  and  resident programs.
  726.                Generally speaking,  bulletin boards  do NOT  get along well
  727.                with  memory  resident  software  such  as  dPath  or Ready!
  728.                Anything that  installs its own keyboard routines will often
  729.                cause conflicts  with the  routines for  the bulletin board.
  730.                You can try to use whatever programs you want with OPUS, but
  731.                there is no  guarantee  that  they  will  work.  If  you are
  732.                experiencing  strange  problems  with  OPUS,  uninstall  any
  733.                memory resident programs, and see if the problem stops.
  734.  
  735.                OPUS!Comm
  736.  
  737.                The low level communications  routines  that  OPUS  uses are
  738.                contained  in  the  OPUS!Comm  program.  This  is  a  memory
  739.                resident  assembly  language  program   that  was  specially
  740.                designed  for   OPUS.  It  supplies  all  the  routines  for
  741.                transferring information from OPUS to the  modem. Because it
  742.                is memory  resident, it should only be run once, and is well
  743.                suited to being installed in the autoexec file.  Simply call
  744.                OPUS!Comm from the autoexec file, and forget about it.
  745.  
  746.                If you  are running  other memory resident programs, you may
  747.                experience  some  difficulty  with  OPUS!Comm.  You  can try
  748.                installing OPUS!Comm  last and  that may  solve the problem,
  749.                but it is NOT guaranteed.
  750.  
  751.                Also, OPUS!Comm is a  superset of  the communications driver
  752.                used by  SEADog<tm>, which  is an  extension of the routines
  753.  
  754.                              OPUS Sysop Manual - Page 7
  755.  
  756.  
  757.  
  758.  
  759.  
  760.                used in FIDO<tm>. As a result, SEADog<tm> will recognize the
  761.                OPUS!Comm  driver  and  use  it instead of its own routines.
  762.                This will  save  you  a  few  bytes  of  memory  if  you run
  763.                SEADog<tm>.
  764.  
  765.                Set TZ=
  766.  
  767.                Internally, OPUS  always works  in Greenwich  Mean Time. You
  768.                rarely are  exposed to  this. OPUS  tries to  adjust to your
  769.                time zone  using a  DOS environment variable called TZ. This
  770.                is a standard practice  for programs  written in  Lattice or
  771.                MicroSoft C  and you  may already have this set correctly if
  772.                you are a C programmer. If not, you  will need  to calculate
  773.                the difference  in time between your time zone and Greenwich
  774.                Mean Time. This is not really that difficult and you can set
  775.                it once  and forget  about it. We have some examples for the
  776.                US, but you're on your own if you  are overseas.  The format
  777.                for the  variable is  xxxyyy where  xxx is  the three letter
  778.                designation  for  your  time  zone  (I.E.  EST  for  Eastern
  779.                Standard  Time),  and  yyy  is  a  two  digit  signed number
  780.                signifying the difference from  Greenwich Mean  Time to your
  781.                time zone.  Countries west of Greenwich will have a positive
  782.                number, and those to the east  will have  a negative number.
  783.                The  sign  is  required  in  the  definition.  Here  are the
  784.                examples for the United States:
  785.  
  786.                     Eastern
  787.                          For standard time.......... SET TZ=EST+05
  788.                          For daylight time.......... SET TZ=EDT+04
  789.  
  790.                     Central
  791.                          For standard time.......... SET TZ=EST+05
  792.                          For daylight time.......... SET TZ=EDT+04
  793.  
  794.                     Mountain
  795.                          For standard time.......... SET TZ=EST+05
  796.                          For daylight time.......... SET TZ=EDT+04
  797.  
  798.                     Pacific
  799.                          For standard time.......... SET TZ=EST+05
  800.                          For daylight time.......... SET TZ=EDT+04
  801.  
  802.  
  803.  
  804.                OPUS defaults to Central Standard Time  which is  CST+06. If
  805.                you are in the central time zone of the U.S., you don't have
  806.                to set this, although it is still a good idea.
  807.  
  808.  
  809.  
  810.  
  811.  
  812.  
  813.                              OPUS Sysop Manual - Page 8
  814.  
  815.  
  816.  
  817.  
  818.  
  819.           Functional Overview
  820.  
  821.                OPUS-CBCS is a  conversational  tool  that  supports several
  822.                different types  of information  transfer. A few notes about
  823.                nomenclature might be in order here.
  824.  
  825.                The Matrix
  826.  
  827.                     The Matrix is  the  OPUS  word  for  network.  This was
  828.                     chosen  instead   of  network   due  to  the  ambiguity
  829.                     associated with the word network in a FIDONet<tm> sense
  830.                     of the word. It is the Matrix which gives OPUS its edge
  831.                     over other <tm> bulletin  board systems.  The Matrix is
  832.                     defined as  being a  group of  bulletin boards to which
  833.                     calls can be made to transfer information. OPUS itself,
  834.                     as of this writing, cannot place outgoing Matrix calls,
  835.                     although it  is  able  to  receive  incoming  mail from
  836.                     FIDO<tm> and  SEADog<tm> systems  at any  time. You may
  837.                     use FIDO<tm> v11w or SEADog<tm> 3.82 or compatible mail
  838.                     programs in  order to place outgoing calls from an OPUS
  839.                     system. OPUS incorporates provisions  to use  either of
  840.                     these  packages   for  originating  mail.  As  of  this
  841.                     writing, OPUS is compatible with SEADog<tm> 4.0 (Yet to
  842.                     be  released),  but  no  guarantees  can  be made about
  843.                     FIDO<tm> v12, because the author has  no information on
  844.                     interfacing to it.
  845.  
  846.                Messages
  847.  
  848.                     Messages can  basically be of three different types, or
  849.                     scopes.  These  are  defined  as  local,  network,  and
  850.                     broadcast.  Depending  on  the  scope,  a  message will
  851.                     behave differently on an OPUS based system.
  852.  
  853.                     Local Messages
  854.  
  855.                     Local  messages  are  the  simplest  form   of  message
  856.                     available.  Almost  all  BBS  systems have this type of
  857.                     messaging system. Local  messages  are  available  to a
  858.                     predefined group  of users,  but only upon the BBS that
  859.                     they were entered. They will not  be marked  to be sent
  860.                     to another BBS system.
  861.  
  862.                     Matrix Messages
  863.  
  864.                     Matrix messages are marked for transmission to a remote
  865.                     system or group of  systems. OPUS  cannot directly send
  866.                     the message,  but the message format is compatible with
  867.                     existing <tm> network mailers,  and fully  supports the
  868.                     SEADog<tm> network  extensions. This type of message is
  869.                     good for sending  a  note  to  a  user  or  sysop  in a
  870.                     different area.  These types of messages can be used to
  871.  
  872.                              OPUS Sysop Manual - Page 9
  873.  
  874.  
  875.  
  876.  
  877.  
  878.                     send files and request files, both on a scheduled basis
  879.                     or as  immediate priority.  The latter requires the use
  880.                     of a SEADog<tm> mailer.
  881.  
  882.                     Broadcast Messages
  883.  
  884.                     Broadcast messages are fully  compatible with EchoMail.
  885.                     EchoMail, by  Jeff Rush,  it is  a means of maintaining
  886.                     the same message base on multiple bulletin boards. This
  887.                     allows  conferencing  on  an international level if you
  888.                     choose to  do so.  Remember, any  Matrix associated, or
  889.                     broadcast   message   still   requires  that  you  make
  890.                     arrangements to transfer mail  via an  external mailer.
  891.                     Also, phone  calls placed  for mail  transfers cost the
  892.                     same as  regular  calls.  You  need  to  be  aware that
  893.                     anything  involving  Matrix  transactions will cost you
  894.                     money to run.
  895.  
  896.                File Section
  897.  
  898.                     File  transfers  can  be  of  three   different  types.
  899.                     Uploads, Downloads,  and Matrix  file transfers are all
  900.                     supported in OPUS. These  protocols allow  you to share
  901.                     software  with  your  users  and  other  bulletin board
  902.                     systems.
  903.  
  904.                     Uploads
  905.  
  906.                     Uploading is defined as  a user  sending a  file to the
  907.                     BBS system.  This allows  users to  share programs that
  908.                     they have written or collected with other users  of the
  909.                     bulletin   board.   Several   transfer   protocols  are
  910.                     supported  in  OPUS.  These   include  Xmodem,  Ymodem,
  911.                     Telink,  SEALink<tm>,   Windowed  Xmodem,  and  Sliding
  912.                     Window Kermit. These will be described  more thoroughly
  913.                     in the file transfer section.
  914.  
  915.                     Downloads
  916.  
  917.                     Downloading  is  defined  as  a  bulletin  board system
  918.                     sending a file to a user. This allows a single point to
  919.                     serve  as  a  'holding  tank'  for software that can be
  920.                     freely shared among users. The same  transfer protocols
  921.                     are available for download as for upload.
  922.  
  923.                     Matrix
  924.  
  925.                     Matrix  transfers  can  either be uploads or downloads,
  926.                     but this works between two Matrix BBS systems. In other
  927.                     words, you  can direct OPUS to mark a message as Matrix
  928.                     with a file attached,  and the  external mailer program
  929.                     will send  that file to the specified system. OPUS will
  930.  
  931.                              OPUS Sysop Manual - Page 10
  932.  
  933.  
  934.  
  935.  
  936.  
  937.                     accept incoming  Matrix files  any time  the program is
  938.                     running.
  939.  
  940.           Operating Philosophy
  941.  
  942.                The operational  philosophy of  OPUS can  be summed  op in a
  943.                very brief statement:
  944.  
  945.                                    KEEP IT SIMPLE!
  946.  
  947.                OPUS is very easy to use when you  let the  installation kit
  948.                do its job. A sysop can lead a very satisfying life with the
  949.                basic OPUS installation. It will still be a superior system,
  950.                and  will  require  a  minimum  of  maintenance.  There  are
  951.                thousands of custom features available; each OPUS board will
  952.                probably look and act differently, but there is no guarantee
  953.                that any  of  the  customization  methods  will  be  easy or
  954.                immediately apparent.  It's best for the novice sysop to run
  955.                a basic system and to gradually start customizing  things as
  956.                he/she gains  experience with  OPUS. That's what we suggest.
  957.                The difficult  functions  are  always  available,  but never
  958.                required. If  you want to tailor your system to look and act
  959.                in just  a  certain  way,  you  can  at  any  time. However,
  960.                remember the rewards you reap are proportional to the amount
  961.                of work you put into the system, and  that can  run into man
  962.                years if you choose for it too.
  963.  
  964.           Differences Between OPUS and FIDO<tm>
  965.  
  966.                OPUS is  NOT a  FIDO<tm> "clone";  it doesn't  always try to
  967.                mimic FIDO<tm> operations.  The  only  compatibility between
  968.                OPUS  and  FIDO<tm>  involves  the  structure of the support
  969.                files. For example, if you are currently running  a FIDO<tm>
  970.                system, then  you can  expect all  of your  "*.BBS" files to
  971.                work with OPUS. That  includes such  text files  as Dir.Bbs,
  972.                Welcome1.Bbs, and  so forth. It also includes the data files
  973.                like User.Bbs, and Mail.Sys.
  974.  
  975.                There is no guarantee  of compatibility  beyond OPUS version
  976.                0.00. If  file structures change, however, you can expect to
  977.                see conversion programs to let you go back and forth between
  978.                structures.
  979.  
  980.           File Structures
  981.  
  982.           This  section  describes  some  of  the major differences in file
  983.           structure  between  OPUS  and  FIDO<tm>  v11w,  and  some  of the
  984.           enhancements in OPUS.
  985.  
  986.                The menu files have the same structure, however the contents
  987.                of the menu files are very different. You must never attempt
  988.                to  operate  OPUS  using  FIDO<tm> "*PRIV.BBS" files or vice
  989.  
  990.                              OPUS Sysop Manual - Page 11
  991.  
  992.  
  993.  
  994.  
  995.  
  996.                versa. All of the menu editing programs that are designed to
  997.                work  with  FIDO<tm>  "*PRIV.BBS"  files will work with OPUS
  998.                because the structures of the files are the same.
  999.  
  1000.                The first  character of  each menu  option does  NOT have to
  1001.                remain the  same in  OPUS. OPUS is sensitive to the relative
  1002.                record position rather than  any  particular  character. For
  1003.                example, if  the third menu option is "M)essages", then OPUS
  1004.                doesn't care if  you  rename  that  to  "N)otes".  The third
  1005.                option would,  in this example always get you to the message
  1006.                section regardless of what its name showed.
  1007.  
  1008.                Although OPUS understands the embedded signals  for FIDO<tm>
  1009.                questionnaires,   we   recommend   that   you   modify   any
  1010.                questionnaire files  to  use  OPUS  embedded  commands. This
  1011.                compatibility will probably be the first to go.
  1012.  
  1013.                OPUS defines two additional access levels:
  1014.  
  1015.                     ASSTSYSOP - between Extra and Sysop
  1016.                     HIDDEN    - above Sysop (mainly to make
  1017.                                 unused menu items invisible)
  1018.  
  1019.           Extended Display File Capability
  1020.  
  1021.                ANSI graphics  are supported  as an option to the user. Each
  1022.                support file has two flavors: Text  and Graphics.  These are
  1023.                differentiated  by  extension  in  that  text  files have an
  1024.                extension of BBS, and graphic files use GBS.
  1025.  
  1026.                Through the  use of  an embedded  command, you  can have any
  1027.                support  file  branch  to  an external program. The sysop is
  1028.                responsible for insuring that the program directs its output
  1029.                through  the   comm  port.   This  feature  allows  multiple
  1030.                "Outside" features to be supported.
  1031.  
  1032.                Questionnaire information can be  collected from  within any
  1033.                BBS/GBS file.  This can  be used  to log the activity of any
  1034.                displayed section of your board.
  1035.  
  1036.                You can insert a  person's name,  display a  quote, date and
  1037.                time  displays,  etc  within  any  BBS/GBS  file.  Virtually
  1038.                anything OPUS knows about the user  can be  displayed at any
  1039.                point in the support files.
  1040.                Additional embedded  commands allow  you to make any BBS/GBS
  1041.                file a submenu.  This  is  handy  for  things  like multiple
  1042.                bulletins,  interactive  help  systems,  etc. For a complete
  1043.                list of embedded commands see Appendix D.
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.                              OPUS Sysop Manual - Page 12
  1050.  
  1051.  
  1052.  
  1053.  
  1054.  
  1055.           Extended File Transfer Protocols
  1056.  
  1057.                OPUS  includes  provisions  for   a   variety   of  transfer
  1058.                protocols.  These  include  Xmodem, Ymodem, WXmodem, Telink,
  1059.                SEALink<tm>, and Super  Kermit.  This  allows  virtually any
  1060.                computer system  to transfer  program files  to and from the
  1061.                bulletin board.
  1062.  
  1063.           EchoMail Enhancements
  1064.  
  1065.                OPUS allows the sysop to determine  whether EchoMail SEEN-BY
  1066.                lines are  displayed to the user. Most people complain about
  1067.                the  unsightliness  of  this  part  of  EchoMail,  and  OPUS
  1068.                eliminates that  problem. If  you do not care about SEEN-BYs
  1069.                at all, OPUS allows you to disable their display.
  1070.  
  1071.                Extended FIDONet<tm> addressing display can be  disabled. As
  1072.                more  distinct  addresses  become available over the Matrix,
  1073.                there will be a  need to  embed more  information within the
  1074.                body of  a message.  OPUS allows  you to control who can and
  1075.                can't see this information.
  1076.  
  1077.                OPUS automatically inserts its own origin line if  a message
  1078.                area is  marked as  broadcast. This  allows other systems to
  1079.                know what package processed the mail.
  1080.  
  1081.                You can tell OPUS to automatically  unARC and  toss incoming
  1082.                EchoMail packets.  In other  words, when an incoming message
  1083.                has an ARCmail packet attached to it, you  can tell  OPUS to
  1084.                take care  of placing  it in  the appropriate  areas. You no
  1085.                longer have to declare an external event to  extract ARCmail
  1086.                packets and toss EchoMail. OPUS does this for you.
  1087.  
  1088.                NOTE: These  features require that you have all your message
  1089.                areas on the same physical drive. Unpredictable results will
  1090.                occur if this is not the case.
  1091.  
  1092.           Mail Interface
  1093.  
  1094.                OPUS has  the ability to receive FIDONet<tm> compatible mail
  1095.                packets at any time. This means that Matrix  transactions do
  1096.                not necessarily have to run at any given time. You send your
  1097.                mail to an OPUS at whatever time is convenient for you. OPUS
  1098.                messages  are  completely  compatible  with  FIDONet<tm> and
  1099.                SEADog<tm>  specifications.  Even  though  it  cannot  place
  1100.                outgoing phone calls, OPUS allows any message entered on the
  1101.                system to  be handled  by a  FIDONet<tm> compatible external
  1102.                mail program.
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.                              OPUS Sysop Manual - Page 13
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.           Extended Message Area Attributes
  1115.  
  1116.                A variety  of message area attributes are supported. You can
  1117.                define exactly what type of messages will be  placed in what
  1118.                area.
  1119.  
  1120.                Areas may  be marked  as being private only. This means that
  1121.                all messages entered in this area will be marked as private,
  1122.                and cannot be read by other users.
  1123.  
  1124.                Areas may  be marked  as public  only. This will require the
  1125.                users to enter messages that can be read by any other user.
  1126.  
  1127.                OPUS supports anonymous messages.  If an  area is  marked as
  1128.                being anonymous,  OPUS will  ask the  user for the name that
  1129.                they want the message to be from.
  1130.  
  1131.                EchoMail message bases are recognized. The user will be told
  1132.                that the  message will  be broadcast, and OPUS automatically
  1133.                inserts the Origin line.
  1134.  
  1135.                Matrix messages are treated  like FIDONet<tm>  messages. The
  1136.                user is asked where the message is to be sent and to whom.
  1137.  
  1138.                Message areas can be marked as being Barricaded. A barricade
  1139.                is a  file  that  defines  legal  passwords  for  that area.
  1140.                Passwords have  a privilege  associated with them, and using
  1141.                this feature you can  allow people  higher privileges within
  1142.                certain areas.
  1143.  
  1144.                Any of  these attributes may be combined in any fashion. You
  1145.                can require all messages in your Matrix area  to be private,
  1146.                or all  EchoMail messages  to be public. It is totally up to
  1147.                the sysop as to how message areas will behave.
  1148.  
  1149.           Message Area Commands
  1150.  
  1151.                OPUS adds four new commands to the message  section, and one
  1152.                new command  to the  Matrix area menu. These allow you to do
  1153.                several things that FIDO<tm> does not allow.
  1154.  
  1155.                F)orward allows you to redirect a  message to  another user.
  1156.                This comes in handy when a user has entered a message to the
  1157.                wrong person. You can respecify who that message is sent to.
  1158.                F)orward  has  another  variation  called Forward as Bombing
  1159.                Run. This allows you  to forward  a message  to a predefined
  1160.                list  of  people  without  having  to  reenter  the  message
  1161.                multiple times.
  1162.  
  1163.                H)url can be  used  to  move  a  message  from  one  area to
  1164.                another. You  can move messages to the appropriate area if a
  1165.                user doesn't understand the  system.  This  also  works very
  1166.  
  1167.                              OPUS Sysop Manual - Page 14
  1168.  
  1169.  
  1170.  
  1171.  
  1172.  
  1173.                well for removing advertisements from EchoMail areas.
  1174.  
  1175.                NOTE: This requires all your message areas to be on the same
  1176.                physical drive. Unpredictable results will occur  if you try
  1177.                to hurl a message to a different drive.
  1178.  
  1179.                =)Read non-Stop  does just  what it says. It will continuous
  1180.                display messages until the  highest message  is reached. The
  1181.                user may  open a capture buffer, go into a message area, and
  1182.                essentially download an entire group of messages for reading
  1183.                offline.
  1184.  
  1185.                S)can will  check for  messages to  the user  in ALL message
  1186.                areas. There are several programs available that will create
  1187.                a  file  listing  pending  messages  for  a  user. With this
  1188.                feature, the user can do this at the time he/she logs on.
  1189.  
  1190.                OPUS does not have a read  message menu  like FIDO<tm> does.
  1191.                All the commands for message areas are contained in one menu
  1192.                making message functions much easier to manage.
  1193.  
  1194.                In the matrix area, you have the ability to manage more than
  1195.                one list  of Matrix addresses. FIDONet<tm> is in the process
  1196.                of  implementing  this  by  adding  an  additional  level of
  1197.                network  called   Zone.  This   is  the  highest  group  and
  1198.                FIDONet<tm> defines these by country. OPUS  uses a different
  1199.                approach.  When  you  choose  Z)one  from the Matrix area in
  1200.                OPUS, you are really  deciding on  which nodelist  OPUS will
  1201.                use. You  can have  as many zones as you choose. They can be
  1202.                grouped by country, continent, or however you want.
  1203.  
  1204.                In OPUS, the message editor commands are contained in a menu
  1205.                file. It  works like  any other  "*PRIV.BBS" file and allows
  1206.                the system operator to set  access  levels  for  the various
  1207.                commands.
  1208.  
  1209.                The LORE  (line-oriented editor)  has an additional command:
  1210.                H)andling. It lets you manually change  the attributes  of a
  1211.                message. Current  attributes consist  of Private, Kill/Sent,
  1212.                File-Attach,  Crash,  File-Request,  Return-Receipt Request,
  1213.                Update-Request, and  Audit-Request. Some of these attributes
  1214.                are for use with  external mail  programs, and  have no real
  1215.                use when sending mail to another OPUS system.
  1216.  
  1217.           File Area Commands
  1218.  
  1219.                Two  new  file  area  commands are added. H)url and O)rphan.
  1220.                H)url works  for  files  just  like  it  does  for messages.
  1221.                O)rphan allows  you to  place entries  in the  file list for
  1222.                files that are in the directory, but not in the file list.
  1223.  
  1224.  
  1225.  
  1226.                              OPUS Sysop Manual - Page 15
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.           Miscellaneous Commands
  1233.  
  1234.                The user is not required to hit the  return key  when he/she
  1235.                logs on to establish a baud rate as he/she does in FIDO<tm>.
  1236.                OPUS does this automatically.
  1237.  
  1238.                ARC and LBR file contents can be displayed. The user can see
  1239.                what files  are contained  in an ARChive without downloading
  1240.                it.
  1241.  
  1242.                OPUS checks to see that a user exists  on the  system when a
  1243.                user addresses  a private  message to him. This insures that
  1244.                every message  is receivable.  This function  is disabled in
  1245.                Matrix and EchoMail areas because these areas imply that the
  1246.                person the message is addressed to  is  not  a  user  of the
  1247.                local board.
  1248.  
  1249.                All  of  the  Sysop  commands  are menu driven in OPUS. This
  1250.                makes board maintenance much easier.
  1251.  
  1252.                The Sysop can either  raise or  lower a  user's time  and or
  1253.                access privilege from the local console.
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.  
  1260.  
  1261.  
  1262.  
  1263.  
  1264.  
  1265.  
  1266.  
  1267.  
  1268.  
  1269.  
  1270.  
  1271.  
  1272.  
  1273.  
  1274.  
  1275.  
  1276.  
  1277.  
  1278.  
  1279.  
  1280.  
  1281.  
  1282.  
  1283.  
  1284.  
  1285.                              OPUS Sysop Manual - Page 16
  1286.  
  1287.  
  1288.  
  1289.  
  1290.  
  1291.                                  THE MESSAGE SECTION
  1292.  
  1293.           What is a Message Section? 
  1294.  
  1295.                Messages  allow  users  to  record notes to each other while
  1296.                they are online.  This allows  questions to  be answered and
  1297.                conversations  to  be  held  between different users and the
  1298.                sysop. Opus implements this in a variety of  forms. Messages
  1299.                can  be  local  to  the  board  or  broadcast  in  a general
  1300.                conversation, and can either  be  public  or  private. These
  1301.                messages   are   grouped   by   category,  with  a  separate
  1302.                subdirectory for each topic on your hard disk.  You can have
  1303.                your messages  grouped however  you want them. The directory
  1304.                structure  allows  you  to  manage  messages  in  an orderly
  1305.                fashion.  You  can  define  many  things about message areas
  1306.                including who can see them, who can enter them, whether they
  1307.                are 'broadcast' or not, and whether they can be deleted. 
  1308.  
  1309.           Setting up a Message Section 
  1310.  
  1311.           System Files 
  1312.  
  1313.                Each category,  or area is referred to by its own number and
  1314.                has its own  separate  configuration  file  that  allows the
  1315.                sysop to  define the  manner in which it will be used. These
  1316.                files are named as 'SYSTEM??.BBS', where "??" stands for the
  1317.                area number.  Valid system  area numbers are 1 thru 99. Each
  1318.                area   is   a   separate   subdirectory,   and   has  unique
  1319.                characteristics.   These   include   location,  description,
  1320.                support, and privilege. 
  1321.            
  1322.           Creating a System File
  1323.  
  1324.                Select "!" at the main menu to access  the Sysop  menu. From
  1325.                this  menu  you  should  choose A)rea maintenance. This menu
  1326.                always defaults to the main system menu, or area 0.  This is
  1327.                the  primary  configuration  for  OPUS. It defines where the
  1328.                main help files are  located,  and  where  messages  left at
  1329.                logoff go. Generally, you will not use the other options for
  1330.                the primary area, and you will set its access to Sysop.
  1331.  
  1332.                To create a new message area, select A)nother area from this
  1333.                menu. Pick  a number  that is  one higher  than your highest
  1334.                system file. If you  have  used  the  installation  kit, you
  1335.                should pick  three. OPUS  will tell you that there is not an
  1336.                area three, and will ask you  if  you  want  to  create one.
  1337.                Select yes, and you will see the area configuration menu.
  1338.  
  1339.           The following  is a  description of each of the items of the area
  1340.           configuration menu. You can set these options as you please, OPUS
  1341.           does not restrict area configuration in any way.
  1342.  
  1343.  
  1344.                              OPUS Sysop Manual - Page 17
  1345.  
  1346.  
  1347.  
  1348.  
  1349.  
  1350.           Privilege
  1351.            
  1352.                This option allows you to set the minimum privilege required
  1353.                for this area  to  be  available  to  the  user.  Using this
  1354.                feature allows  you to  restrict usage  of a message base to
  1355.                the people  you have  authorized. There  are currently eight
  1356.                access levels: 
  1357.  
  1358.                     TWIT 
  1359.                     DISGRACE 
  1360.                     NORMAL 
  1361.                     PRIVIL 
  1362.                     EXTRA 
  1363.                     ASST. SYSOP 
  1364.                     SYSOP 
  1365.                     HIDDEN
  1366.  
  1367.                This  allows  you  to  set general access restrictions for a
  1368.                message base. You could have a general message base assigned
  1369.                a privilege  of normal,  and a  private area devoted to your
  1370.                close friends defined as privil,  and  be  assured  that the
  1371.                private conversation  would remain  that way. See the Access
  1372.                Level description in the Sysop section later in  this manual
  1373.                for more details on privileges.
  1374.  
  1375.           Setting Paths
  1376.  
  1377.                Most  of  the  rest  of  the  configuration section involves
  1378.                setting the DOS pathnames to the  various support  files. We
  1379.                do not  intend to provide a tutorial on DOS. You should know
  1380.                enough  about  that  already.  We  will  give  you  a little
  1381.                background about  the way OPUS treats pathnames. First, OPUS
  1382.                requires all paths to be fully qualified. That  is, you must
  1383.                specify  drive  and  subdirectory  in  each of the following
  1384.                items. If you don't, OPUS will  tell you  about it,  and you
  1385.                will have  to reenter  the path. This is done to insure that
  1386.                all the information is  absolutely where  OPUS can  find it.
  1387.                This also holds true in the control file though the compiler
  1388.                will not be so forgiving. More on that later on.
  1389.  
  1390.                Second, OPUS requires all  paths to  end in  a trailing "\".
  1391.                Just to  keep you on your toes, OPUS automatically puts this
  1392.                in for you in the system file configuration, but does NOT in
  1393.                the  control  file.  When  you  are  dealing with OPUS in an
  1394.                interactive mode, I.E. from the "!" menu, you do not have to
  1395.                enter  trailing  backslashes.  All  paths  specified  in the
  1396.                control file must have them. Got it???
  1397.  
  1398.           BBS Path
  1399.            
  1400.                The BBS is the path to the privilege  files to  use for this
  1401.                area.  Privilege  files  allow  you  to  define  which  menu
  1402.  
  1403.                              OPUS Sysop Manual - Page 18
  1404.  
  1405.  
  1406.  
  1407.  
  1408.  
  1409.                commands are available to the user. Even though a user has a
  1410.                high enough privilege to access an area, he/she will not see
  1411.                the menu options that are set to a higher access  level than
  1412.                his. Setting the privil files is discussed later under sysop
  1413.                commands. 
  1414.            
  1415.                               *** For Advanced Users*** 
  1416.            
  1417.                     You  can  have  several  sets  of  priv files
  1418.                     contained  in  different subdirectories. This
  1419.                     allows you to set  two  areas  to  access the
  1420.                     same message  base with different privileges.
  1421.                     This  allows  you  to   give  several  people
  1422.                     extended privileges  within certain areas, by
  1423.                     accessing different area numbers. Think about
  1424.                     it. 
  1425.            
  1426.           Help Path
  1427.            
  1428.                This allows  you to  specify the  path to the help files for
  1429.                this area. These files are displayed  when the  help key (?)
  1430.                is pressed at the menu for this area. 
  1431.            
  1432.                              *** For Advanced Users*** 
  1433.            
  1434.                     Theoretically, you can display different help
  1435.                     files  for  each  area,   but  this   is  not
  1436.                     generally used. 
  1437.             
  1438.           Message Path 
  1439.            
  1440.                This is the DOS path to the actual messages. This can be any
  1441.                valid DOS directory, and will be  the storage  place for the
  1442.                messages. When you initially set this path, OPUS will report
  1443.                that it cannot find a file called "DIR.BBS"  and ask  you if
  1444.                you want  to create  one. If you answer no to this question,
  1445.                you cannot use the T)itles option  described below,  and you
  1446.                are on your own to create this file.
  1447.            
  1448.           File Path
  1449.            
  1450.                This is  the corresponding  file area.  See the file section
  1451.                for a description. 
  1452.            
  1453.           Titles
  1454.            
  1455.                Each side of the area has a title  that the  user sees. This
  1456.                is  the  topic  or  category,  and is maintained in the file
  1457.                'DIR.BBS' in the appropriate  subdirectory. OPUS  allows you
  1458.                to  modify   the  contents   of  this  file  from  the  area
  1459.                maintenance  menu.  It  generally  consists  of  a  one line
  1460.                description of  the contents  of the  area. This description
  1461.  
  1462.                              OPUS Sysop Manual - Page 19
  1463.  
  1464.  
  1465.  
  1466.  
  1467.  
  1468.                will be displayed immediately  above the  menu and  when the
  1469.                user chooses  A)reas unless the sysop has configured OPUS to
  1470.                use Msgareas.Bbs. (See  the  installation  gude  for further
  1471.                details).
  1472.  
  1473.           Area Types 
  1474.            
  1475.                There  are  three  basic  area  types  for  messages: Local,
  1476.                Matrix, and EchoMail. These determine the  way a  message is
  1477.                handled by Opus. 
  1478.            
  1479.           Local 
  1480.            
  1481.                Messages that  are tagged local will only appear on the BBS,
  1482.                and will not be seen  by  users  of  another  bulletin board
  1483.                service. These can be either private or public, and can have
  1484.                anonymous names, but will only be  recorded on  the computer
  1485.                the user is talking to when the message is entered.
  1486.            
  1487.           Matrix 
  1488.            
  1489.                These messages  are sent  through the  matrix, that is, they
  1490.                are generated in one  city, and  are sent  to another single
  1491.                city. This  is the  equivalent of a letter. The user decides
  1492.                who it will be sent to, and where they live,  and your board
  1493.                will generate  a message that is compatible with an external
  1494.                mail program  that can  deliver the  message. Naturally, you
  1495.                can define  the users  who can  send mail to other users via
  1496.                the Matrix. This is discussed under the Mail section.  
  1497.  
  1498.           EchoMail 
  1499.            
  1500.                This is a  means  to  share  message  bases  between several
  1501.                boards. It  allows you to create conferences that are shared
  1502.                between different parts  of  the  country.  EchoMail  is not
  1503.                free. It  still costs you the charge of sending a message to
  1504.                the Echo connection, but  it generally  allows conversations
  1505.                at a greatly reduced cost. Opus supports EchoMail internally
  1506.                for reception; it is up to the sysop to maintain  a means of
  1507.                sending mail to another system. 
  1508.            
  1509.                EchoMail uses  several programs  to link Opus to an external
  1510.                mail processor for managing EchoMail areas.  See the related
  1511.                EchoMail documentation  for details on how to participate in
  1512.                EchoMail. Opus provides direct  support  for  incoming mail,
  1513.                and subsequent  EchoMail processing. Therefore, the sysop is
  1514.                freed from the task of implementing it in  batch files. (See
  1515.                the echomail special considerations section.) 
  1516.  
  1517.  
  1518.  
  1519.            
  1520.  
  1521.                              OPUS Sysop Manual - Page 20
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.           Area Aspects
  1528.  
  1529.                The aspects  you set  for an area determine the way messages
  1530.                behave within that area. You can customize aspects  to allow
  1531.                users to  only read,  only post public messages, or to allow
  1532.                them to post anonymous  messages.  Once  again,  OPUS leaves
  1533.                this entirely up to the sysop.
  1534.  
  1535.           Privilege Levels
  1536.  
  1537.                The privilege  you assign  an area determines the users that
  1538.                can access that area. This  allows  you  to  determine which
  1539.                users can read certain areas. Privs are downwards inclusive.
  1540.                This means that any  user can  access areas  of his  priv or
  1541.                lower. For  example, you  have set up four areas, two set to
  1542.                normal, one set to privil, and one set to extra. A user with
  1543.                normal privilege will be able to access the first two areas.
  1544.                A privileged user will be able to access  the third  area as
  1545.                well as  the first  two, and  an extra  user will be able to
  1546.                access all four areas. Privilege levels are the most general
  1547.                type of area aspects.
  1548.  
  1549.           Public-Only
  1550.  
  1551.                Message areas  can be marked as being public-only. This will
  1552.                eliminate the question as to whether or not a message should
  1553.                be marked  private. All  messages entering  in a public-only
  1554.                area may be read by any user.
  1555.  
  1556.           Private-Only
  1557.  
  1558.                You can mark a message area as being private only also. This
  1559.                will automatically tag every message as being private to the
  1560.                recipient. This is the inverse of  the above,  and will also
  1561.                eliminate  the  "Private?(Y/N)"  question. The difference is
  1562.                that with this  attribute,  all  messages  will  be private,
  1563.                while those  areas marked  with the  previous attribute will
  1564.                contain nothing but public messages.
  1565.  
  1566.           Public-or-Private
  1567.  
  1568.                This is the default  message area  aspect. The  user will be
  1569.                asked whether  messages should be marked private, but public
  1570.                and private messages can be mixed within the area.
  1571.  
  1572.           Read-Only
  1573.  
  1574.                This attribute sets a message area to be non-postable. Users
  1575.                can  read  messages  as  much  as they want, but they cannot
  1576.                enter messages.  This is  useful for  general release notes,
  1577.                mini-bulletins, etc.
  1578.  
  1579.  
  1580.                              OPUS Sysop Manual - Page 21
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.           Anonymous-OK
  1587.  
  1588.                OPUS allows  the user  to enter  the name  to be used in the
  1589.                from field if this attribute  is  set.  Normally,  the users
  1590.                name is used in messages. You can use this to allow users to
  1591.                enter a pseudonym instead  of their  name when  they enter a
  1592.                message. This  is used  mostly in  EchoMail areas where many
  1593.                users discuss things.
  1594.           Special Considerations for Matrix Messages
  1595.  
  1596.                Although any of the above settings can be  used in  a Matrix
  1597.                area, it is generally not a good idea to change this area to
  1598.                allow anything other than normal messages. When OPUS creates
  1599.                a new  system file,  it defaults to being public and private
  1600.                messages,  with  no  additional  attributes.  All   that  is
  1601.                necessary here  is to  add the Matrix attribute to the list,
  1602.                and  you  are  ready  to  go.  The  other  options  that are
  1603.                configurable  in  a  Matrix  area are set within the control
  1604.                file.
  1605.  
  1606.           NetInfo
  1607.  
  1608.                The first  option in  setting a  Matrix area  is the NetInfo
  1609.                path.  This   tells  OPUS  where  to  find  the  FIDONet<tm>
  1610.                compatible nodelist. The syntax for the statement is:
  1611.                     Path NetInfo d:\(path)\
  1612.                where d: is a logical drive on your system and (path) is the
  1613.                subdirectory  where  you  intend  to keep the nodelist. OPUS
  1614.                itself cannot maintain this nodelist. To  keep this  list up
  1615.                to  date  you  must  use  a  utility  such  as  OPUSnode, or
  1616.                Xlatlist. OPUSnode is included  in the  distribution kit and
  1617.                you  should  refer  to  the  documentation  with it for more
  1618.                information on maintaining nodelists.
  1619.  
  1620.           OPUSnode
  1621.  
  1622.                OPUSnode is an external nodelist compiler that allows you to
  1623.                create   nodelists   that   are  compatible  with  FIDO<tm>,
  1624.                SEADog<tm>, and  OPUS. Without  a nodelist,  you cannot send
  1625.                Matrix messages  with any  of the  external mailer programs.
  1626.                See the OPUSnode  documentation  for  details  on  usage and
  1627.                syntax.
  1628.  
  1629.           Cost Accounting
  1630.  
  1631.                Because  sending  Matrix  messages  to  a  remote system can
  1632.                involve making long  distance  phone  calls,  OPUS maintains
  1633.                accounting information  in the user file just like FIDO<tm>.
  1634.                If a user does not have enough credit  to place  an outgoing
  1635.                call, he/she  cannot send  any Matrix  messages. You can use
  1636.                any of the external user file utilities that  are compatible
  1637.                with  FIDO<tm>  v11w  user  file  structures  to set a users
  1638.  
  1639.                              OPUS Sysop Manual - Page 22
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.                credit. We recommend using REMSYS20, by  Bernie Lawrence. It
  1646.                understands all  of the  extended OPUS attributes and can be
  1647.                run either from the local console, or through the modem.
  1648.  
  1649.           You can set a multitude of options about  the Matrix  area. These
  1650.           are all contained in the control file. The best documentation for
  1651.           the control file is the sample file contained in the installation
  1652.           kit. It  was written  by the  author and is the definitive source
  1653.           for setting the control  file options.  This section  only covers
  1654.           the options that relate to the Matrix area.
  1655.  
  1656.           Handling Crashmail
  1657.  
  1658.                A  large   portion  of  the  Matrix  configuration  involves
  1659.                specifying how  OPUS  handles  incoming  mail.  This section
  1660.                describes each of those options.
  1661.  
  1662.           Refuse Crashmail
  1663.  
  1664.                You  can  keep  OPUS  from  accepting incoming mail. This is
  1665.                useful if you are not a member of the Matrix. If you  do not
  1666.                belong to  any Matrix group, you should include this in your
  1667.                control file:
  1668.                     MATRIX Refuse Crashmail
  1669.  
  1670.           After Crashmail Exit
  1671.  
  1672.                After OPUS receives mail,  you can  exit the  program with a
  1673.                DOS ERRORLEVEL set. This is for those who need to do special
  1674.                message/file processing after an  incoming packet.  The most
  1675.                obvious  use  is  EchoMail's  Scan.  This is accomplished by
  1676.                including this line in the control file:
  1677.                     MATRIX After Crashmail Exit xx
  1678.                where 'xx' is the DOS ERRORLEVEL you wish to exit OPUS with.
  1679.                The sysop  is responsible  for trapping  this errorlevel and
  1680.                taking the appropriate action in the batch file.
  1681.  
  1682.           IFNA<tm> Kludge
  1683.  
  1684.                The International FIDO<tm> Association  has devised  a means
  1685.                for  systems  using  their  amateur  e-mail  network to pass
  1686.                extended control information with  other  programs.  This is
  1687.                mostly  extended  addressing  information  for international
  1688.                mail and auditing information that tracks  the processing of
  1689.                mail. You  can set the privilege level of users that can see
  1690.                this extended information. Setting this priv  to HIDDEN will
  1691.                prevent OPUS  from displaying  this information  at all. The
  1692.                syntax for this statement is:
  1693.                     MATRIX Kludge <priv>
  1694.                where <priv> is any  valid  privilege  level  (See Privilege
  1695.                Levels above).
  1696.  
  1697.  
  1698.                              OPUS Sysop Manual - Page 23
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.           Extract ARCmail
  1705.  
  1706.                ARCmail  is  an  external  mail packeting program created by
  1707.                System Enhancement  Associates. It  is commonly  used in the
  1708.                processing and transfer of EchoMail. When ARCmail is crashed
  1709.                to your board, you  can tell  OPUS to  automatically extract
  1710.                the compressed packets. If you use this feature, the program
  1711.                ARCE.COM must  be available  on your  DOS path.  ARCE is not
  1712.                OPUS software,  and it  is not supplied with this system. To
  1713.                use the  automatic extraction  feature include  this in your
  1714.                control file:
  1715.                     MATRIX Extract ARCmail
  1716.                If you do not have enough memory to run ARCE, see the sample
  1717.                control file for an  example of  how to  do this  by exiting
  1718.                OPUS after an incoming mail packet.
  1719.  
  1720.           After ARCmail Exit
  1721.  
  1722.                This is  a special  variation of  the "After Crashmail Exit"
  1723.                option. The statement for this is:
  1724.                     MATRIX After ARCmail Exit xx
  1725.                where 'xx' is once again a DOS ERRORLEVEL.
  1726.  
  1727.           Default Settings
  1728.  
  1729.                You can also tell OPUS what  defaults to  use for  a message
  1730.                entered  in  the  Matrix  area.  This  includes  things like
  1731.                private, kill/sent, etc. This allows you  to specify exactly
  1732.                what a  user can  and cannot do with a Matrix message. There
  1733.                are two groups of  configuration  options  here:  Assume and
  1734.                Ask. If the attributes are not either assumed or asked, they
  1735.                are ignored. The sysop  can  always  override  these default
  1736.                settings using the H)andling option.
  1737.  
  1738.           MATRIX Assume vs. MATRIX Ask
  1739.  
  1740.                Assumed  attributes   are  automatically  set  for  messages
  1741.                entered in the Matrix area. Some of them  will only  work if
  1742.                you are  using SEADog<tm> for your external mailer. The user
  1743.                does not have to do anything to set  assume attributes, OPUS
  1744.                takes  care   of  it.  On  the  other  hand,  setting  Asked
  1745.                attributes will make OPUS  ask the  user if  he/she wants to
  1746.                set  this  attribute  when  the  message  is  entered.  Some
  1747.                attributes are more suited to Assume while others are better
  1748.                off  being  asked.  For  example,  Kill/Sent  is  better off
  1749.                assumed as it generally  confuses the  user. The  syntax for
  1750.                these commands is:
  1751.                     MATRIX <verb> <attribute>
  1752.                where <verb> is either Assume or Ask, and <attribute> is one
  1753.                of the below.
  1754.  
  1755.  
  1756.  
  1757.                              OPUS Sysop Manual - Page 24
  1758.  
  1759.  
  1760.  
  1761.  
  1762.  
  1763.           Kill/Sent
  1764.  
  1765.                This attribute tells the  external mailer  program to delete
  1766.                the message  after it is sent. A Matrix message is addressed
  1767.                to a remote bulletin board and is generally  of no  use once
  1768.                it has  been successfully  sent. Specifying this option will
  1769.                help keep your Matrix area tidy  and decrease  the amount of
  1770.                time your external mailer takes to process messages.
  1771.  
  1772.           File Attach
  1773.  
  1774.                Specifying this  option will  make OPUS ask the user for the
  1775.                name of a file to be sent to the remote system.
  1776.  
  1777.                     WARNING!!!  In  this  version  of  OPUS, file
  1778.                     attaches can  be from  any valid path on your
  1779.                     system. If  you set  file attach  to ask, the
  1780.                     user  can  send  ANY  file  on your system to
  1781.                     another system, where  it  can  be publically
  1782.                     downloaded. In  future versions, this will be
  1783.                     keyed off  of  a  privilege  level,  and will
  1784.                     incorporate some protections, but not yet. DO
  1785.                     NOT SET FILE ATTACH TO ASK IN OPUS 0.00!!!
  1786.  
  1787.                If File Attach is not asked, the user cannot send  a file to
  1788.                a remote system. The system operator, on the other hand, can
  1789.                get around this limitation by specifying  the full  path and
  1790.                name of  the file  to be  sent as the subject, and using the
  1791.                H)andling command set the file attach bit.
  1792.  
  1793.           The rest of the message attributes  will  only  work  if  you are
  1794.           using SEADog<tm> as your external mailer. SEADog<tm> and OPUS use
  1795.           a superset of  the  FIDO<tm>  attribute  specifications. FIDO<tm>
  1796.           will ignore  any of  the attributes listed below. This is a brief
  1797.           description of some of  the  extended  attributes  available with
  1798.           SEADog<tm>.  See   the  SEADog<tm>  manual  for  a  more  verbose
  1799.           description of these attributes.
  1800.  
  1801.           Crashmail
  1802.  
  1803.                Crashmail is defined as mail to be sent  at any  time of the
  1804.                day. OPUS  can accept  mail 24 hours a day if you so choose.
  1805.                It can also be used as the bulletin  board under SEADog<tm>.
  1806.                If you  implement the system this way, you can both send and
  1807.                receive mail all the time.
  1808.  
  1809.           File Request
  1810.  
  1811.                You can tell OPUS to set  the attribute  for the  message to
  1812.                file  request.  This  tells  the  system  that  receives the
  1813.                message to send the requested file back to your system.
  1814.  
  1815.  
  1816.                              OPUS Sysop Manual - Page 25
  1817.  
  1818.  
  1819.  
  1820.  
  1821.  
  1822.           Update Request
  1823.  
  1824.                An update request is similar to  a file  request except that
  1825.                the file  will only be sent back if it is newer than the one
  1826.                that you already have on your system.
  1827.  
  1828.           Return Receipts
  1829.  
  1830.                If you specify a return receipt, the remote system will send
  1831.                you back a message telling you when it received the message,
  1832.                and  whether  or  not   the   transmission   was  completely
  1833.                successful.  This  is  very  useful  when the system you are
  1834.                calling is known to have bad phone lines, or you  are making
  1835.                an  overseas  transmission.  If your external mailer program
  1836.                uses routing, you may get nastygrams  back from  the host of
  1837.                the remote  system. Some  sysops do not like having to spend
  1838.                the money to deliver receipts.
  1839.  
  1840.           Audit Trail
  1841.  
  1842.                Audit Trails can give you  very  tedious  details  about the
  1843.                route a  message or  file took  between your  system and the
  1844.                remote  system.  As  with  return  receipts,   other  sysops
  1845.                generally  dislike  having  to  make phone calls to give you
  1846.                this information.
  1847.  
  1848.           You can  set any  or all  of the  extended attributes  if you are
  1849.           using  FIDO<tm>  as  your  mailer program. Some of the attributes
  1850.           will be passed on, mainly the request and receipt functions. This
  1851.           allows you to get some of the functionality of SEADog<tm> without
  1852.           having to purchase it!
  1853.  
  1854.           Special Considerations for EchoMail
  1855.  
  1856.           OPUS supports incoming EchoMail directly. That means that you can
  1857.           use  OPUS  instead  of  ARCmail  and TossMail to process mail you
  1858.           receive. In most cases, OPUS processes  incoming mail  much, much
  1859.           faster than  the external  programs. Of  course, this  may not be
  1860.           true for your system as it  depends greatly  on the  hardware you
  1861.           are using.
  1862.  
  1863.           Configuration Note
  1864.  
  1865.                All  of  OPUS'  EchoMail  support depends on you setting all
  1866.                your message areas up on  the  same  logical  drive.  If you
  1867.                spread message  bases between several drives, DO NOT attempt
  1868.                to use these features! Unpredictable results will occur.
  1869.  
  1870.           Areas.Bbs
  1871.  
  1872.                In order for OPUS to process your EchoMail,  it has  to have
  1873.                the EchoMail  support file "Areas.Bbs" in the path specified
  1874.  
  1875.                              OPUS Sysop Manual - Page 26
  1876.  
  1877.  
  1878.  
  1879.  
  1880.  
  1881.                by  NetInfo.  If  this  file  does  not  exist  in  the path
  1882.                specified  by   NetInfo,  OPUS   will  not  handle  EchoMail
  1883.                directly. You can still use the  external EchoMail programs;
  1884.                OPUS will just ignore any references to EchoMail support.
  1885.  
  1886.           Origin Line
  1887.  
  1888.                If OPUS  finds your  Areas.Bbs file,  and a  message area is
  1889.                marked as  being an  EchoMail area,  OPUS will automatically
  1890.                insert an  Origin line  at the  bottom of the message when a
  1891.                user saves a message. This origin  line is  fully compatible
  1892.                with EchoMail  version 1.3?.  The difference is that it will
  1893.                say "OPUS" on that line  to  differentiate  OPUS  from other
  1894.                EchoMail systems.
  1895.  
  1896.           Automatic Toss
  1897.  
  1898.                You  can  configure  OPUS  to automatically process incoming
  1899.                EchoMail. (See the Extract ARCmail section for that  half of
  1900.                the process)  OPUS can  do all  the functions of TossMail if
  1901.                you tell it to. To do so, you  should specify  the following
  1902.                line in the control file:
  1903.                     MATRIX Toss EchoMail
  1904.                Once you've  done this,  OPUS will process incoming EchoMail
  1905.                with no further intervention required. You basically set it,
  1906.                and forget about it.
  1907.  
  1908.           Seenby Displays
  1909.  
  1910.                OPUS will  suppress the display of EchoMail SEEN-BY lines if
  1911.                you tell it to. EchoMail uses these lines to determine which
  1912.                boards have  already received a copy of a message. Sometimes
  1913.                the seenby line is longer  than  the  message,  though. Much
  1914.                like  the  IFNA<tm>  kludge,  this  is primarily an internal
  1915.                function, and can confuse the user.  If you  set this option
  1916.                to HIDDEN,  you will  never have to see a seenby line again.
  1917.                You can set the privilege level  that will  see seenby lines
  1918.                with the following line in the control file:
  1919.                     Echo Seenby <priv>
  1920.                where  <priv>  is  any  valid  user privilege (See Privilege
  1921.                Levels above).
  1922.  
  1923.           Processing Outbound EchoMail
  1924.  
  1925.                At the time of  this  writing,  OPUS  does  NOT  support the
  1926.                processing  of  outbound  EchoMail.  This will be covered in
  1927.                later releases of OPUS. You can  use whatever  is convenient
  1928.                to you  to achieve this externally. Generally, you will have
  1929.                to implement the following somewhere in an external event if
  1930.                you  are  using  Jeff  Rush's  EchoMail  and  SEA's  ARCmail
  1931.                programs:
  1932.  
  1933.  
  1934.                              OPUS Sysop Manual - Page 27
  1935.  
  1936.  
  1937.  
  1938.  
  1939.  
  1940.                     SCANMAIL RUN
  1941.                     ARCMAIL TO LIST AREAS.BBS
  1942.                (See the E)vents section under the sysops commands  later in
  1943.                this document  for details  on how  to do this with OPUS, or
  1944.                the manual for your external mailer program).
  1945.  
  1946.           Enhanced Message Area Commands
  1947.  
  1948.           As mentioned previously, OPUS provides three  additional commands
  1949.           above and  beyond those  provided in FIDO<tm>. These commands are
  1950.           primarily for use by the  sysop,  but  can  be  configured  to be
  1951.           available to  whatever level  of user  the sysop  wants. They are
  1952.           standard menu entries and can be set to  any privilege  using the
  1953.           "!" (sysop)  menu, or  can be  changed by any FIDO<tm> compatible
  1954.           menu editor. You can allow first time callers  to have  access to
  1955.           these commands,  but it  is not  recommended. Generally, you will
  1956.           want these commands  to  be  available  to  sysops  and co-sysops
  1957.           exclusively.  (See  the  P)riv  section  under the sysop commands
  1958.           later in this document for details on setting menu privileges)
  1959.  
  1960.           The Hurl Command
  1961.  
  1962.                This command allows you to move a message  from one  area to
  1963.                another. This  is very  similar to  the M)ove command in the
  1964.                Mail interface for SEADog<tm>. It will  copy a  message from
  1965.                one  area  to  another  taking  into  account  the number of
  1966.                messages in the destination  directory.  In  other  words, a
  1967.                message you  hurl will  end up  being the highest message in
  1968.                the directory you move  it to.  You specify  the destination
  1969.                directory by number.
  1970.  
  1971.           The Forward Command
  1972.  
  1973.                Forward allows you to change the recipient of a message. You
  1974.                can respecify the addressee of any  message. If  the message
  1975.                is in  the Matrix  area, OPUS  will ask  you for the network
  1976.                address again.
  1977.  
  1978.           Forward With Bombing Run
  1979.  
  1980.                This option is accessed by entering 'FB' at the menu prompt.
  1981.                This  allows  you  to  send  the  same message to a group of
  1982.                people. This group is specified by a text file. The name and
  1983.                location can be anything you wish, but you have to tell OPUS
  1984.                exactly what it is you want  to  do  with  this  command. In
  1985.                other words,  you probably  should specify the full path and
  1986.                filename when using this feature.
  1987.  
  1988.  
  1989.                Also, OPUS is not particularly bright about the  contents of
  1990.                the bombing  run file. It has a very specific format, and if
  1991.                you do not follow that  format  EXACTLY,  OPUS  will  try to
  1992.  
  1993.                              OPUS Sysop Manual - Page 28
  1994.  
  1995.  
  1996.  
  1997.  
  1998.  
  1999.                follow your instructions, and will make a very large mess of
  2000.                the entire affair.
  2001.  
  2002.                The format for the bombing run file is as follows:
  2003.  
  2004.                     The beginning of each  line  starts  with the
  2005.                     address  destination  in  the  format  of net
  2006.                     number, followed by a slash, followed  by the
  2007.                     node number. After the address, you enter ONE
  2008.                     and ONLY ONE space, followed by  the name you
  2009.                     want the message to be addressed to. The name
  2010.                     field  follows  the  format  of  the standard
  2011.                     FIDONet<tm>    nodelist.   I.E.   Underscores
  2012.                     instead of  spaces. You  MUST use underscores
  2013.                     instead of spaces. For example, a bombing run
  2014.                     file would look like this:
  2015.  
  2016.                     100/10 Joe_Blow
  2017.                     103/12 Henry_Ford
  2018.                     etc....
  2019.  
  2020.           The Zone Command
  2021.  
  2022.                In the Matrix area,  there is  a special  new command called
  2023.                Z)one. This  allows you  to specify  the nodelist to be used
  2024.                for  Matrix  addressing.  This  defaults  to   the  nodelist
  2025.                specified in the control file, but by using this option, you
  2026.                can specify which of several lists OPUS will use to find the
  2027.                Matrix  address.  If  a  user  has enough credit, he/she can
  2028.                instruct your system  to  place  a  call  to  Hong  Kong, or
  2029.                Australia, or  some place equally expensive. This allows you
  2030.                to  strip  out  all  international  addresses  and  only let
  2031.                continental  mail  be  sent. Currently, FIDO<tm> has reached
  2032.                the limits of its  nodelist  handling  capabilities,  and is
  2033.                simply ignoring network addresses higher than the maximum it
  2034.                understands. OPUSnode allows you to break  the nodelist into
  2035.                several discrete  sections for use with your external mailer
  2036.                program.
  2037.            
  2038.                     NOTE: Z)one is an  internal command  to OPUS.
  2039.                     The  sysop  is  responsible for insuring that
  2040.                     the external mailer can understand the Matrix
  2041.                     address  that  OPUS  puts  in the message. If
  2042.                     this mailer is  FIDO<tm>,  you  probably will
  2043.                     not be able to do much with the capability to
  2044.                     address   multiple   nodelists.   If   it  is
  2045.                     SEADog<tm>, then  there is  not much point in
  2046.                     using this feature.  OPUS  supports  the Zone
  2047.                     designation  in  this  manner  primarily  for
  2048.                     future extensions to the OPUS mail interface.
  2049.  
  2050.  
  2051.  
  2052.                              OPUS Sysop Manual - Page 29
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.           Special Message Areas
  2059.  
  2060.                There are two additional types of message areas supported in
  2061.                OPUS; Hidden and Barricaded. This allows you to create areas
  2062.                that only certain users can access  WITHOUT allowing  them a
  2063.                higher privilege,  and to allow extended privileges within a
  2064.                certain area. The variations  on  this  idea  are countless.
  2065.                This  will  provide  many  different  security  levels to be
  2066.                configured without any additional work for the sysop.This is
  2067.                a VERY advanced concept and should be explored by the novice
  2068.                sysop gradually.
  2069.  
  2070.           Hidden Areas
  2071.  
  2072.                During the develpment of OPUS, we  came across  a quirk that
  2073.                has proved  very useful.  No one  really thought  it out; it
  2074.                just happened. Since then, this has  become one  of the most
  2075.                popular aspects of running an OPUS system.
  2076.  
  2077.                You can  define a  system file  that is more than one higher
  2078.                than the highest existing system  file.  I.E.  you  can have
  2079.                areas 1  thru 10  and 20.  Area 20 will be an area that acts
  2080.                exactly like any other area, but it will not show up for the
  2081.                user in  any list. Valid area numbers for Hidden areas are 1
  2082.                thru 49. The "Hidden" areas are a low security means to keep
  2083.                the  general  public  from  accessing an area. The user must
  2084.                know that the  area  exists  to  get  there,  but  if he/she
  2085.                randomly types the area number, there is nothing to keep him
  2086.                out of that area. You will  find that  as OPUS  becomes more
  2087.                popular, users  will try to access each and every area in an
  2088.                attempt to read areas they are  not authorized  to read. Its
  2089.                not that  every user out there is a "black hacker magician";
  2090.                they are  naturally curious,  and will  explore any possible
  2091.                combination of  commands they can think of. This is why OPUS
  2092.                provides Barricaded areas.
  2093.  
  2094.           Barricaded Areas
  2095.  
  2096.                Barricaded areas use a separate configuration file to define
  2097.                the password  and privilege  a user  will have in that area.
  2098.                Even if a  user  randomly  chooses  the  area  number  for a
  2099.                arricaded  area,  they  will  still  have to know a password
  2100.                before being  allowed entry  to that  area. Valid Barricaded
  2101.                area numbers are 50 thru 99.
  2102.  
  2103.                When you  create a  system file higher than 50, OPUS changes
  2104.                the BBS path to Barricade path. This is  the fully qualified
  2105.                path  designation  for  a  file  that contains the barricade
  2106.                information. You can specify the filename  for this  file in
  2107.                addition  to  the  path;  it  is  not  hard-coded. As in the
  2108.                bombing run file, this file must follow a specific format:
  2109.  
  2110.  
  2111.                              OPUS Sysop Manual - Page 30
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.                     Each line starts with a password. This can be
  2118.                     any number  of characters up to 255, but keep
  2119.                     it reasonable. If you specify much  more than
  2120.                     20 or 30 characters, your user may run out of
  2121.                     time before he/she types in the password!
  2122.  
  2123.                     After the password, follows one, and only one
  2124.                     space. Any more or less and the user will not
  2125.                     be able to access the area. The last  word of
  2126.                     the  line  is  the  privilege  descriptor  as
  2127.                     described  in  previous  sections.   If  OPUS
  2128.                     decides  that  the  format  of  this  file is
  2129.                     wrong, or that the user is  not authorized to
  2130.                     enter the area, his privilege will be lowered
  2131.                     to the minimum. The only way  to recover from
  2132.                     this  is  to  logoff  and log back on. Once a
  2133.                     user misstypes  the password  for a protected
  2134.                     area, he/she will be reduced to TWIT and will
  2135.                     not  be  able   to   recover   without  sysop
  2136.                     intervention.
  2137.  
  2138.                     The password file can contain as many entries
  2139.                     as  you  like,  and  you  can  have  multiple
  2140.                     passwords  for  similar  privileges.  This is
  2141.                     what an example control file would look like:
  2142.  
  2143.                          abc twit
  2144.                          password normal
  2145.                          additional privil
  2146.                          xyz twit
  2147.                          newpassword extra
  2148.                          oldpassword privil
  2149.  
  2150.                     This file would allow  users to  enter either
  2151.                     'abc' or  'xyz' as  a password  to enter that
  2152.                     area with a privilege of twit.  A password of
  2153.                     'password' would  alow them access at normal,
  2154.                     and 'additional' and 'oldpassword'  would get
  2155.                     them privil. We think you get the idea.
  2156.  
  2157.                The sysop  is responsible for informing users what passwords
  2158.                to use in what areas. OPUS will allow  anyone who  can enter
  2159.                the  appropriate  password  access  to that area. Barricades
  2160.                generally are used to allow friends  and business associates
  2161.                extended privileges to certain areas.
  2162.  
  2163.                The privilege  a user gets in a barricaded area is temporary
  2164.                and only works in  that  area.  This  allows  you  to  map a
  2165.                password  protected  area  to  a normal area and designate a
  2166.                "moderator" for a message area. For instance, system  file 3
  2167.                points  to  a  directory  called 'C:\Msgs\Group' and so does
  2168.                area 51. Normal users can enter area 3 and do whatever users
  2169.  
  2170.                              OPUS Sysop Manual - Page 31
  2171.  
  2172.  
  2173.  
  2174.  
  2175.  
  2176.                normally do  in message  areas. You have a password file for
  2177.                area 51 that gives users who enter a password of 'moderator'
  2178.                the privilege  of sysop.  This allows your friend Joe to act
  2179.                as the sysop within area 3  if  he/she  enters  area  51 and
  2180.                gives the appropriate password.
  2181.  
  2182.                Within the distribution kit you will find a file called
  2183.                TEST.DOC. This quizzes you  on  details  of  hidden and
  2184.                barricaded message  areas. You should complete the quiz
  2185.                and mail it back to one of the info nodes. Ready???
  2186.  
  2187.  
  2188.           Hints, Tricks, and Sleight of Hand
  2189.  
  2190.                One of the primary  purposes in  OPUS is  to handle bulletin
  2191.                board tasks  as quickly  and efficiently  as possible. Every
  2192.                aspect of OPUS was written with  speed as  the primary goal.
  2193.                You will find that it fulfills this goal on its own with the
  2194.                exception of a couple of  areas.
  2195.  
  2196.           Directory Sorts
  2197.  
  2198.                OPUS tries very hard  to  find  its  configuration  files as
  2199.                quickly  as  possible.  Due  to  the nature of DOS, this can
  2200.                still take quite a  bit of  time unless  you help  OPUS from
  2201.                time to  time. You will find that OPUS will run much quicker
  2202.                if you use some utility to sort your  directories. Professor
  2203.                Norton's DIRSORT works very nicely. This has two advantages.
  2204.                First, by nature, it sorts all directory names to the top of
  2205.                the directory  listing. This allows OPUS to fly through path
  2206.                finding operations.  Second,  directory  sorting  will force
  2207.                deleted file  entries to  the bottom of the list. You dodn't
  2208.                know DOS kept entries for deleted file??? Of  course. That's
  2209.                why when you delete all but one file in a directory it takes
  2210.                half a lifetime to display a directory.
  2211.  
  2212.                OPUS can deal with unsorted directories just fine - you just
  2213.                sacrifice  speed.   There  are   many  utilities  that  sort
  2214.                directories and they  improve  performance  greatly.  If you
  2215.                don't already have one, you should consider finding one.
  2216.  
  2217.           Renumbering Message Areas
  2218.  
  2219.                By nature,  message areas are not necessarily contiguous. As
  2220.                a message base ages, messages are either killed by users, or
  2221.                deleted by  date. As  this occurs,  "holes" are  left in the
  2222.                message base structure. These  holes slow  down the  time it
  2223.                takes OPUS  takes to  determine the highest message, and how
  2224.                quickly OPUS finds the next highest message for  viewing. If
  2225.                you  do   not  periodically  renumber  your  message  areas,
  2226.                eventually, OPUS will spend all its  time skipping directory
  2227.                entries and will never get its work done.
  2228.  
  2229.                              OPUS Sysop Manual - Page 32
  2230.  
  2231.  
  2232.  
  2233.  
  2234.  
  2235.                Naturally,  there  are  solutions  that  take  care  of this
  2236.                problem. One, RENUM by Bob Hartman, seems to  work best with
  2237.                OPUS.  It  has  several  options  only  one of which we will
  2238.                discuss here. RENUM  will  go  through  a  message  base and
  2239.                insure that the highest message number actually reflects the
  2240.                highest number of message files.  In  other  words,  it will
  2241.                eliminate  any  gaps  you  may  have in your message base by
  2242.                changing the higher message numbers  to  fill  in  the gaps.
  2243.                Your messages  will still be in chronological order, it does
  2244.                not rearrange  them, it  just insures  that if  you have 100
  2245.                messages available, they are numbered one thru one hundred.
  2246.                OPUS remembers the highest message a user has read.
  2247.  
  2248.                Due   to   the   limitations   placed   on  it  by  FIDO<tm>
  2249.                compatibility, OPUS can only  maintain high  message markers
  2250.                for  ten  areas  in  the  user file. FIDO<tm> only maintains
  2251.                eight. However, OPUS knows that  the  sysop  will  mainly be
  2252.                reading  messages   from  the  local  console,  and  uses  a
  2253.                different means to record the highest  message read  for the
  2254.                sysop.  This  involves  treating  the  marker in the fashion
  2255.                SEADog<tm> uses. Each  time  you  read  a  message  from the
  2256.                keyboard, a  file called  LASTREAD is updated in the message
  2257.                area you are reading. Because this information is maintained
  2258.                in the  same directory  that the  messages are  in, OPUS can
  2259.                maintain an infinite number of message pointers. If  you use
  2260.                Bob Hartman's  RENUM to maintain your message bases you need
  2261.                to specify '-S' as the first  parameter of  the command line
  2262.                to  tell   RENUM  to  maintain  the  LASTREAD  files.  While
  2263.                providing support to  an  unlimited  number  of  areas, this
  2264.                feature  is  restricted  to  one  user.  If  you use another
  2265.                renumbering program, you need  to insure  that it  takes the
  2266.                LASTREAD files into account.
  2267.  
  2268.           Disk Optimizing
  2269.  
  2270.                Last,  but   not  least,  you  need  to  run  some  sort  of
  2271.                optimization on your disk  drives  periodically.  Because of
  2272.                the way  DOS manages  directories, you  will end  up with an
  2273.                area that is mostly deleted files.  This is  especially true
  2274.                if you  use EchoMail  and ARCmail. By nature, these programs
  2275.                generate a whole bunch  of  messages  and  then  delete them
  2276.                after moving the information to another directory. DOS still
  2277.                retains a directory entry  for each  deleted file.  You will
  2278.                find  that  the  more  deleted  file  entries there are in a
  2279.                directory,  the  slower  the   programs  that   access  that
  2280.                directory will work. This is especially true of EchoMail and
  2281.                ARCmail. The slow down is proportional, but not on a  one to
  2282.                one basis.  If you  have half as many messages to process as
  2283.                you have directory entries, you should expect to  spend four
  2284.                times the  amount of time processing them. This is not quite
  2285.                so obvious with small message  bases  as  it  is  with large
  2286.                ones, but the delay is still there.
  2287.  
  2288.                              OPUS Sysop Manual - Page 33
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.                We  have  found  DOG  (Disk  OrGanizer)  to  be  a very good
  2295.                solution to this problem. It has options to allow you to run
  2296.                it unattended  in a batch file, and its Fast option seems to
  2297.                take care of the problem without wasting a  lot of  time. On
  2298.                an eight  megahertz 286 based machine it generally takes two
  2299.                minutes if run daily.
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.  
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.  
  2329.  
  2330.  
  2331.  
  2332.  
  2333.  
  2334.  
  2335.  
  2336.  
  2337.  
  2338.  
  2339.  
  2340.  
  2341.  
  2342.  
  2343.  
  2344.  
  2345.  
  2346.  
  2347.                              OPUS Sysop Manual - Page 34
  2348.  
  2349.  
  2350.  
  2351.  
  2352.  
  2353.                                   THE FILE SECTION
  2354.  
  2355.           What is a File Section?
  2356.  
  2357.                The file  section  of  OPUS  allows  the  users  to exchange
  2358.                programs and information contained in files that they create
  2359.                offline. File sections are treated much the same  as message
  2360.                sections, and  configuring them  is so  similar that we will
  2361.                only discuss the areas that directly affect the file areas.
  2362.  
  2363.           Configuring a File Area
  2364.  
  2365.                You configure the area of your hard drive  that will contain
  2366.                a file  section very  similarly to  the manner  in which you
  2367.                configure a message section. Select the "!" command from the
  2368.                main menu,  and pick A)rea maintenance. There are only three
  2369.                options here that affect file areas.
  2370.  
  2371.                Upload Path
  2372.  
  2373.                The DOS path you specify here is where  files that  are sent
  2374.                TO your  system will  be stored. You can set all your upload
  2375.                paths   to   the   same   subdirectory,   or   to   separate
  2376.                subdirectories. The  sysop is  entirely on his own to manage
  2377.                these files once they are sent.
  2378.  
  2379.                Download Path
  2380.  
  2381.                This path specifies where OPUS will look for  files that the
  2382.                user  requests  to  be  sent  to him. You should divide your
  2383.                download areas up by type of program. I.E. use one  area for
  2384.                utilities  and  another  for  games.  You  can have up to 99
  2385.                individual file areas.
  2386.  
  2387.                Titles
  2388.  
  2389.                Each file area has a one line description which is contained
  2390.                in the file Dir.Bbs in the download path. OPUS allows you to
  2391.                change the contents of this file using the  T)itles command.
  2392.                This description  is displayed  at the  top of the menu when
  2393.                the user is in a file  area. This  description will  also be
  2394.                displayed  whenever  the  user  chooses A)reas from the file
  2395.                section menu unless the sysop  has  configured  OPUS  to use
  2396.                FileArea.Bbs. (See the installation guide for more details).
  2397.  
  2398.           Files.Bbs
  2399.  
  2400.                The  list  of  files  in  an  area  is contained in the file
  2401.                Files.Bbs in the area subdirectory. OPUS maintains this list
  2402.                for you  for files that are sent to your system. The file is
  2403.                a standard text file,  and  can  be  created  with  any text
  2404.                editor that  outputs pure  ASCII files.  The basic format of
  2405.  
  2406.                              OPUS Sysop Manual - Page 35
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.                the file is as follows:
  2413.                     <filename> <description>
  2414.                with one  filename  listed  per  line.  Multiple description
  2415.                lines are  supported as  long as the first character of each
  2416.                line in the description is a space.
  2417.  
  2418.                Comments
  2419.  
  2420.                Lines that begin with a dash ("-") are used for  headers and
  2421.                important announcements  in Files.Bbs.  Whenever OPUS sees a
  2422.                dash as the first character of a line, it changes the screen
  2423.                color to  white if the user has graphics enabled. For normal
  2424.                comments and  multiple line  file descriptions,  use a space
  2425.                for the  first character of the line. You can place comments
  2426.                anywhere in Files.Bbs.
  2427.  
  2428.                End-of-List Character
  2429.  
  2430.                The end-of-list character is the "@" sign. If OPUS sees this
  2431.                character  as  the  first  character  of a line, it will not
  2432.                display anything in the file after  that character.  This is
  2433.                useful  for  allowing  users  to  upload  files into an area
  2434.                without allowing  subsequent download  of the  file until it
  2435.                has been checked by the sysop.
  2436.  
  2437.                Wildcards
  2438.  
  2439.                OPUS allows wildcards to be included in Files.Bbs. When OPUS
  2440.                encounters a wildcard in the files  listing, it  will expand
  2441.                the file  list to include any files that match the wildcard.
  2442.                If there is a description after the wildcard, it will follow
  2443.                the last file matching the wildcard that OPUS finds. This is
  2444.                very useful for maintaining lists of files that  are sent to
  2445.                your system  via mail.  Because these files are not uploaded
  2446.                by a user, OPUS does NOT add a line to  Files.Bbs signifying
  2447.                that the  file is available. This feature allows you to make
  2448.                files that are sent  to your  system available  for download
  2449.                without requiring any maintenance.
  2450.  
  2451.                Wildcard  support  is  very  limited and should be used with
  2452.                care by the sysop. Files listed  with wildcards  can only be
  2453.                downloaded by  users that are privil and above, and commands
  2454.                like L)ocate will not find these files. This  is a temporary
  2455.                limitation and will be changed in future versions.
  2456.  
  2457.           Handling Dates
  2458.  
  2459.                OPUS allows  the sysop  to handle dates in the file lists in
  2460.                several ways.  The  sample  control  file  explains  this in
  2461.                greater  detail.  Suffice  to  say, if you need Files.Bbs to
  2462.                contain a date after the filename, OPUS can be configured to
  2463.                do that  for you.  However, this will disable the display of
  2464.  
  2465.                              OPUS Sysop Manual - Page 36
  2466.  
  2467.  
  2468.  
  2469.  
  2470.  
  2471.                new files for  the  user.  Normally,  OPUS  will  display an
  2472.                asterisk by  the file date if the file has been added to the
  2473.                system since the last time a user called. Hard-coding a date
  2474.                into Files.Bbs will disable this feature, but may allow some
  2475.                utilities like Shuffle and FFM to  work with  OPUS formatted
  2476.                Files.Bbs  listings.  If  this  is important to you, see the
  2477.                sample control file for information on how to place dates in
  2478.                Files.Bbs.
  2479.  
  2480.           Quirks, Peculiarities, and Caveats
  2481.  
  2482.                There  are  several  aspects  of  file areas that need to be
  2483.                mentioned here. Several  are  useful  for  monitoring system
  2484.                usage, while  others are  merely offshoots  of the design of
  2485.                OPUS.
  2486.  
  2487.                OPUS will never overwrite a file that exists in a file area.
  2488.                FIDO<tm>  uses  an  attribute  bit  to  allow  files  to  be
  2489.                overwritten in the network mail  area.  OPUS  allows  you to
  2490.                configure  that  bit,  but  it  will  ignore  it,  and never
  2491.                overwrite a file. Instead, it will change the last character
  2492.                of  the  file  extension  to a sequential decimal number. In
  2493.                other words, if you have  a  file  called  "file.txt"  in an
  2494.                area, and  a user tries to upload a file with the same name,
  2495.                OPUS will name the  first upload  to "file.tx0".  The second
  2496.                will be "file.tx1" and so on. After ten duplicate files have
  2497.                been uploaded, OPUS simply stops accepting that filename.
  2498.  
  2499.                The sysop is free to use any of the embedded commands within
  2500.                a files.bbs  listing. You  can record  information about the
  2501.                user in a log if you want, or  even place  menu instructions
  2502.                in this  file if  you wish,  although it  serves no purpose.
  2503.                (See  the  Embedded  Commands  section  below).  Of  primary
  2504.                importance here are the line privilege commands. and rest of
  2505.                file privilege codes.
  2506.  
  2507.                     WARNING!!!   Shuffle   will   suffer  extreme
  2508.                     delusions  if   you  use   it  with  embedded
  2509.                     commands. Use the built  in OPUS  commands to
  2510.                     manage files  if you  use these codes in your
  2511.                     Files.Bbs listings.
  2512.  
  2513.           External File Transfer Programs
  2514.  
  2515.           OPUS supports several file  transfer  protocols  in  the  form of
  2516.           external programs.  In other words, you must have another program
  2517.           besides OPUS to  allow  users  to  make  use  of  these commands.
  2518.           Currently,  the  author  of  OPUS  is working with the authors of
  2519.           OPUS!Comm to make a generic external  transfer program interface.
  2520.           Future versions  of OPUS  will allow  you to specify any protocol
  2521.           for which you can provide the code for  as long  as it  meets the
  2522.           specifications for the OPUS interface.
  2523.  
  2524.                              OPUS Sysop Manual - Page 37
  2525.  
  2526.  
  2527.  
  2528.  
  2529.  
  2530.           Sliding Window Kermit
  2531.  
  2532.                Super Kermit  is supported in the file CKERMIT.EXE by Jan A.
  2533.                van der Eyk. You must tell  OPUS where  this file  is in the
  2534.                control  file.  If  present,  users may use this fast, full-
  2535.                duplex protocol for both upload and download. Many thanks to
  2536.                Columbia  University  for  developing  this outstanding file
  2537.                transfer protocol.
  2538.  
  2539.           Windowed Xmodem
  2540.  
  2541.                This is implemented in the same fashion as Super Kermit. The
  2542.                required  program  is  WXMODEM.COM.  You  must  specify  the
  2543.                location of this program in the control file in order for it
  2544.                to  be  accessed  by  users.  (See  the installation kit for
  2545.                details).
  2546.  
  2547.           Future versions of OPUS will include support for Chuck Forsberg's
  2548.           ZModem protocol. We simply ran out of time for this release. This
  2549.           protocol is running  a  close  race  with  Super  Kermit  for the
  2550.           fastest file transfer routine available.
  2551.  
  2552.  
  2553.  
  2554.  
  2555.  
  2556.  
  2557.  
  2558.  
  2559.  
  2560.  
  2561.  
  2562.  
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.  
  2569.  
  2570.  
  2571.  
  2572.  
  2573.  
  2574.  
  2575.  
  2576.  
  2577.  
  2578.  
  2579.  
  2580.  
  2581.  
  2582.  
  2583.                              OPUS Sysop Manual - Page 38
  2584.  
  2585.  
  2586.  
  2587.  
  2588.  
  2589.                                  OPUS SYSOP SUPPORT
  2590.  
  2591.           Installing OPUS Software
  2592.  
  2593.                OPUS comes with an installation program that will do most of
  2594.                the work of installing  the system  for you.  You should let
  2595.                these programs do their job BEFORE you go mucking about with
  2596.                the way OPUS works.  Manual installation  is NOT recommended
  2597.                at all. See the installation kit for further details.
  2598.  
  2599.           The Control File
  2600.  
  2601.                The primary  emphasis in  OPUS is speed. Everything possible
  2602.                has been done to make OPUS  work as  quickly and efficiently
  2603.                as possible.  In order  to increase the speed of loading the
  2604.                program, much of the configuration information  is contained
  2605.                in a control file. This file deals with paths and privileges
  2606.                mainly.  All  of  the  options  in  the  control   file  are
  2607.                documented, and  you should refer to the sample control file
  2608.                for an explanation of each command.
  2609.  
  2610.           The Control File Compiler
  2611.  
  2612.                The compiler takes a text file that you  build and  turns it
  2613.                into memory-image  information for  OPUS to use. The program
  2614.                OPUS_CTL.EXE  MUST  be  run   each  time   you  change  your
  2615.                configuration options.  If you do not run the compiler, OPUS
  2616.                will use your old control file.
  2617.  
  2618.                To compile an OPUS control file, issue the following command
  2619.                from the DOS prompt in your OPUS root directory:
  2620.  
  2621.                     OPUS_CTL <control file name>
  2622.  
  2623.                OPUS_CTL will  convert the  control file to machine-readable
  2624.                code. This is done to decrease  the work  OPUS has  to do at
  2625.                startup time.  If a  control file  was not  used, OPUS would
  2626.                have to do the work  of  OPUS_CTL  each  and  every  time it
  2627.                executed.
  2628.  
  2629.                The  control  file  that  you  can  change  and  is readable
  2630.                defaults to an extension of "CTL" for "Control". This is the
  2631.                file that  you can  manually change.  The compiler creates a
  2632.                runtime image of this  information and  stores it  in a file
  2633.                named the  same as  your control file, but with an extension
  2634.                of "PRM" for "Parameters". You can create as  many different
  2635.                parameter files  as you  wish. The  parameter file that OPUS
  2636.                uses is specified on the command line when OPUS is invoked.
  2637.  
  2638.           Command Line Options
  2639.  
  2640.                OPUS supports several items on  the  command  line.  This is
  2641.  
  2642.                              OPUS Sysop Manual - Page 39
  2643.  
  2644.  
  2645.  
  2646.  
  2647.  
  2648.                primarily for SEADog<tm> support. The following is a list of
  2649.                things you can specify on the command line:
  2650.  
  2651.                Parameter File
  2652.  
  2653.                The first item in the parameter  list  is  the  name  of the
  2654.                control file  that you  wish OPUS to use. You do NOT specify
  2655.                an extension unless  you  have  changed  the  extension from
  2656.                "PRM".
  2657.  
  2658.                Baud Rate
  2659.  
  2660.                As  with  FIDO<tm>,  you  can  specify  the  baud rate of an
  2661.                incoming call for use with SEADog<tm>. The syntax is:
  2662.                     -bxxxx
  2663.                where 'xxxx'  is  the  baud  rate  of  the  caller.  See the
  2664.                SEADog<tm> manual for details.
  2665.  
  2666.                Time
  2667.  
  2668.                You  can  tell  OPUS  how  much  time  remains till the next
  2669.                SEADog<tm> event. Use this syntax:
  2670.                     -txxx
  2671.                where  'xxx'  is  the  number  of  minutes  until  the  next
  2672.                SEADog<tm> event.
  2673.  
  2674.                Port
  2675.  
  2676.                Comm ports can be specified using this parameter:
  2677.                     -px
  2678.                where x  is the  communications port. Valid parameters are 1
  2679.                and 2.
  2680.  
  2681.                Unpack Mail
  2682.  
  2683.                If you invoke OPUS with a  '-u' switch,  it will  attempt to
  2684.                unpack any  received mail.  If mail  packets are found, OPUS
  2685.                will do whatever you have told it to do in the control file.
  2686.  
  2687.           The Sysop Menu ("!")
  2688.  
  2689.                OPUS allows most of  the configuration  that is  not support
  2690.                file  specific  to  be  done  online. All sysop commands are
  2691.                accessed via  the "!"  command on  the main  menu. The sysop
  2692.                menu supports  all of  the commands accessible using numeric
  2693.                commands in FIDO<tm>. The big difference is that  all of the
  2694.                OPUS  commands  are  menu  driven,  and  you  don't  have to
  2695.                remember obscure syntax rules to use them.
  2696.  
  2697.  
  2698.  
  2699.  
  2700.  
  2701.                              OPUS Sysop Manual - Page 40
  2702.  
  2703.  
  2704.  
  2705.  
  2706.  
  2707.                A)rea Maintenance
  2708.  
  2709.                There is not much point in discussing this  command further.
  2710.                It is  fully covered in the above sections. It allows you to
  2711.                specify the paths and privileges for message and file areas.
  2712.  
  2713.                D)elete Messages
  2714.  
  2715.                This command  allows you  to delete  messages by  date or by
  2716.                whether they  have been received or not. In other words, you
  2717.                can tell OPUS to delete all messages that  have been sitting
  2718.                around for  a while.  This prevents your board from becoming
  2719.                "dated". Usually,  you will  use this  to eliminate messages
  2720.                that are  older than  about a  month or so. If a user is not
  2721.                interested enough to call your board at least  once a month,
  2722.                he is  not interested in conversing with other users on your
  2723.                board. Delete by date  will unconditionally  delete messages
  2724.                that are older than a time frame you specify.
  2725.  
  2726.                Delete  Received  will  kill  any messages that have already
  2727.                been received by the user. OPUS will ask if a message should
  2728.                be  deleted  at  the  time  it is received, but users do not
  2729.                always say yes to this question. This command will eliminate
  2730.                any old received messages that might be lying about.
  2731.  
  2732.                Both of  these features are included in the external program
  2733.                RENUM by Bob Hartman. The sysop  can implement  this program
  2734.                in a  fashion that will automatically do the above functions
  2735.                on a daily basis.  See the  RENUM documentation  for further
  2736.                details.
  2737.  
  2738.                M)atrix Setup
  2739.  
  2740.                This command  is the equivalent of the FIDO<tm> "4" command.
  2741.                It allows you to set your Matrix address(es)  and select the
  2742.                paths  to  your  Matrix  message  area and Matrix file area.
  2743.                Addresses  are  determined  by  the  administration  of  the
  2744.                amateur network  you belong to. OPUS allows you to specify a
  2745.                primary  and  alternate   net/node   number.   This  command
  2746.                maintains the  information contained  in the file "Mail.Sys"
  2747.                and is fully compatible with FIDONet<tm>.  See your external
  2748.                mailer  program   documentation  for   more  information  on
  2749.                addresses.
  2750.  
  2751.                The paths you set using this command coorespond  to a system
  2752.                file's paths that you have marked as being a Matrix area. In
  2753.                other words, regardless of what you have set using the A)rea
  2754.                maintenance command,  you must duplicate this information in
  2755.                this configuration file. This  redundancy  will  probably go
  2756.                away  in  future  versions  of  OPUS,  but for now, you must
  2757.                specify your mail paths in two places.
  2758.  
  2759.  
  2760.                              OPUS Sysop Manual - Page 41
  2761.  
  2762.  
  2763.  
  2764.  
  2765.  
  2766.                     Hint: Most sysops set  this command  once and
  2767.                     forget  about  it.  If,  for some reason, you
  2768.                     change the locations  of  your  mail messages
  2769.                     and  files,  it  is  very  easy  to forget to
  2770.                     change this option. 
  2771.  
  2772.                          REMEMBER TO CHANGE YOUR  MAIL PATHS
  2773.                          IN   BOTH   A)REA  MAINTENANCE  AND
  2774.                          M)ATRIX SETUP!!!
  2775.  
  2776.                E)vent Manager
  2777.  
  2778.                This option allows you  to manage  OPUS events.  Events tell
  2779.                OPUS to do certain things at certain times. See the enclosed
  2780.                "REF_EVNT.DOC" file for further information.
  2781.  
  2782.                P)riv. Setup
  2783.  
  2784.                Using  this  option,  the  sysop  can   define  the  minimum
  2785.                privilege required  to access  a menu item. This item allows
  2786.                you to change the privilege for any item that appears  on an
  2787.                OPUS menu  with the  exception of the file transfer protocol
  2788.                menu. You  can  use  this  command  to  configure  what menu
  2789.                options  are  available  to  what users, including the sysop
  2790.                menu. Any menu item in  OPUS  can  be  assigned  any  of the
  2791.                available privilege  levels between TWIT and HIDDEN. See the
  2792.                enclosed "REF_PRIV.DOC" file for a description  of privilege
  2793.                levels.
  2794.  
  2795.                O)utside Command
  2796.  
  2797.                This  command  allows  you  to  exit OPUS with an ERRORLEVEL
  2798.                specified in  the  control  file.  FIDO<tm>  calls  this the
  2799.                "Zero" command. You can use this to allow you to exit to DOS
  2800.                when you call your system from a remote location. This  is a
  2801.                very  powerful  command,  and  should  be  used  with  GREAT
  2802.                caution.
  2803.  
  2804.           Author's Note
  2805.  
  2806.                OPUS has been developed over  an  extended  period  of time.
  2807.                This  document  has  existed  for  a  very  brief time. As a
  2808.                result, this section is not quite  as complete  as it should
  2809.                be.  I  am  relying  very heavily on other support documents
  2810.                that were never really meant to be used for this purpose. It
  2811.                is 45 minutes until OPUS is released to the public, and this
  2812.                document is not complete  yet. Within  a couple  of weeks, a
  2813.                more complete  document will  be made available. Until then,
  2814.                you will have to dig through the technical reference docs to
  2815.                find  the  rest  of  the  information that should be in this
  2816.                document.
  2817.  
  2818.  
  2819.                              OPUS Sysop Manual - Page 42
  2820.  
  2821.  
  2822.  
  2823.  
  2824.  
  2825.           Events
  2826.  
  2827.                See "REF_EVNT.DOC"
  2828.  
  2829.           Embedded Commands
  2830.  
  2831.                See "REF_CTRL.DOC"
  2832.  
  2833.           User Access Levels
  2834.  
  2835.                See "REF_PRIV.DOC"
  2836.  
  2837.           Sysop's Keyboard
  2838.  
  2839.                See "REF_KBD.DOC"
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.  
  2854.  
  2855.  
  2856.  
  2857.  
  2858.  
  2859.  
  2860.  
  2861.  
  2862.  
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.  
  2869.  
  2870.  
  2871.  
  2872.  
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.                              OPUS Sysop Manual - Page 43
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.                                      APPENDICES
  2885.  
  2886.  
  2887. OPUS Program and Support File List
  2888.  
  2889. ----------------- Files used by Opus -------------
  2890.  
  2891.   The following files are hard-coded in Opus, and cannot
  2892.   be renamed.
  2893.  
  2894. CHGPRIV  BBS - C)hange menu
  2895. DIR      BBS - Area header in each area.
  2896. FILES    BBS - File listing in each file area.
  2897. EDITPRIV BBS - Message editor menu
  2898. FILEPRIV BBS - File menu
  2899. MAILPRIV BBS - Matrix menu
  2900. MAINPRIV BBS - Main menu
  2901. MSGPRIV  BBS - Message menu
  2902. SYSPRIV  BBS - Sysop menu
  2903. SYSTEM   BBS - Main System file
  2904. SYSTEM1  BBS - Message / File area 1
  2905. SYSTEM2  BBS - Message / File area 2 (etc......)
  2906. LASTUSER BBS - User record of last user to go outside.
  2907. SCHED    BBS - Schedular record
  2908. OPUSCHAT TXT - Chat buffer
  2909. MAIL     SYS - Net/Node number record
  2910. OPUSGRAF EXE - Displays settings in Control file
  2911. OPUS_CTL EXE - Control file compiler
  2912. F1       BBS \
  2913. F2       BBS  \
  2914. F3       BBS   \
  2915. F4       BBS    \
  2916. F5       BBS     \  Function key display files.
  2917. F6       BBS     /  These can be .GBS for graphics
  2918. F7       BBS    /
  2919. F8       BBS   /
  2920. F9       BBS  /
  2921. F10      BBS /
  2922. C        HLP - C)hange help screen
  2923. FILES    HLP - File area help screen
  2924. MAIL     HLP - Matrix help screen
  2925. MAIN     HLP - Main menu help screen
  2926. MSG      HLP - Message area help screen
  2927. OPUS     EXE - Opus itself
  2928.  
  2929.     The following file CAN be changed in Opus, but
  2930. should not be changed if you are running a Opus/Fido setup.
  2931.  
  2932. ANSWER   BBS - Q)uestionaire answer file
  2933. USER     BBS - User records
  2934. BULLETIN BBS - System Bulletin
  2935. WELCOME1 BBS - Initial welcome screen
  2936.  
  2937.                              OPUS Sysop Manual - Page 44
  2938.  
  2939.  
  2940.  
  2941.  
  2942.  
  2943. WELCOME2 BBS - Second welcome screen
  2944. EDTORIAL BBS - System Editorial
  2945. NEWUSER1 BBS - Initial New user screen
  2946. NEWUSER2 BBS - Second new user screen
  2947. QNEWUSER BBS - Auto questionnaire for new users
  2948. QUESTION BBS - Q)uestionaire file
  2949. QUOTES   BBS - System Quotes
  2950.  
  2951.  
  2952.    These files can be renamed with impunity.
  2953.  
  2954. OPUS     CTL - Opus Control File
  2955. OPUS     LOG - Sysop Log
  2956. OPUS     PRM - Opus Parameter file (compiled OPUS.CTL)
  2957. EDITOR   BBS - Help screen for the Editor
  2958. INQUIRE  BBS - help screen for the Inquire command
  2959. LOCATE   BBS - help screen for the Locate command
  2960. BYEBYE   BBS - Logoff screen
  2961. CONTENTS BBS - help screen for the Contents command
  2962. DAYLIMIT BBS - Shown to users that have no time left for the day.
  2963. FILEAREA BBS - List of file areas.
  2964. LEAVING  BBS - Show to users before they go outside
  2965. MSGAREA  BBS - list of message areas
  2966. RETURN   BBS - Shown to users returning from Outside
  2967. REP_EDIT BBS - Help for the REPLACE option on the Editor menu
  2968. ROOKIE   BBS - Welcome 2 screen for users with less than 7 calls.
  2969. TIMEWARN BBS - Time limit warning
  2970. TOOSLOW  BBS - Shown to users that are calling at too slow a baud rate.
  2971. WHY_ANSI BBS - help screen for the (ANSI y/n) question
  2972. WHY_FB   BBS - help screen for the logoff message prompt.
  2973. WHY_HU   BBS - Help for the G)oodbye command
  2974. WHY_PVT  BBS - help for the (Private y/n/) prompt on messages.
  2975. XFERBAUD BBS - Screen for users that are too slow to up/download
  2976.  
  2977.  
  2978.  
  2979.  
  2980.  
  2981.  
  2982.  
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.  
  2989.  
  2990.  
  2991.  
  2992.  
  2993.  
  2994.  
  2995.  
  2996.                              OPUS Sysop Manual - Page 45
  2997.  
  2998.  
  2999.  
  3000.  
  3001.  
  3002. Embedded Commands
  3003.  
  3004. You can lead a full and meaningful life without using any of these
  3005. control codes.  In fact, misusing them can probably lead to a lot  of
  3006. grief.  There is nothing here for the novice.  If you are not intimately
  3007. familiar with Opus and running communication systems, please don't continue.
  3008.  
  3009. Most of the control codes assume you know what you are doing.  Because the
  3010. GBS/BBS files are prepared with a word processor or text editor (ie...not
  3011. using any Opus software), there is no way for Opus to check your work.
  3012. You should review any files you create using Opus's KEYBOARD MODE before
  3013. trusting the file to an on-line situation.  The Control-O commands (below)
  3014. can be particularly lethal if you aren't careful.
  3015.  
  3016. An overabundance of control codes in a BBS/GBS file can make a totally
  3017. unmaintainable file.  You can build these files using any text editor
  3018. that's capable of inserting control codes into files, but I would consider
  3019. such a method the "Assembly Language of BBS/GBS Files".  A handy Opus sysop
  3020. utility would be some sort of program (eg. WYSIWYG BBS/GBS editor) to make
  3021. these control codes more readable to the sysop during development.  At this
  3022. writing, no such utility exists.
  3023.  
  3024. [soapbox on]
  3025.  
  3026. It's very possible to use these commands to turn a perfectly good system
  3027. into one full of gimcracks (useless junk).  An Opus sysop has an order of
  3028. magnitude more power over his/her system than does a Fido<tm> v11 sysop.
  3029.  
  3030. If you take that control, you must also share the responsibility.  I think
  3031. it's great to add a little spice to a system, but the average user doesn't
  3032. call in order to see his/her screen wiggle.  These commands are intended
  3033. to give the experienced sysop lots of versatility.
  3034.  
  3035. They are very easy to over-do!
  3036.  
  3037. Also... remember that if you use the MsDOS graphics characters in a BBS/GBS
  3038. file, you are going to make non-MsDOS screens look funny because they
  3039. won't know how to display the characters.  There is absolutely nothing
  3040. "non-standard" in Opus itself.  If you choose to add such features, you
  3041. also need to be prepared to answer questions and/or complaints about them.
  3042.  
  3043. [soapbox off]
  3044.  
  3045. These control codes can be inserted into any .BBS or .GBS file.
  3046. The only exception is DIR.BBS ... which must be a plain text file.
  3047.  
  3048.  
  3049.  
  3050.  
  3051.  
  3052.  
  3053.  
  3054.  
  3055.                              OPUS Sysop Manual - Page 46
  3056.  
  3057.  
  3058.  
  3059.  
  3060.  
  3061.                   THE BASICS -------------------------------------------------
  3062.  
  3063.          ^A       ... "Press ENTER to continue: "
  3064.          ^B       ... disable ^C/^K aborting
  3065.          ^C       ... enable ^C/^K aborting
  3066.          ^D       ... Mark that it's a good time for a "MORE?"
  3067.          ^E       ... Turn auto-More ON  (default)
  3068.          ^F       ... COMBINATION COMMAND (see below)
  3069.          ^G       ... Ring the caller's bell
  3070.          ^H       ... Backspace
  3071.          ^I       ... Tab
  3072.          ^J       ... Line feed
  3073.          ^K       ... Turn auto-More OFF
  3074.          ^L       ... Clear screen
  3075.          ^M       ... Carriage return
  3076.          ^N       ... [ reserved ]
  3077.          ^O       ... COMBINATION COMMAND (see below)
  3078.          ^P       ... COMBINATION COMMAND (see below)
  3079.          ^Q       ... Used for XON/XOFF. Never use this.
  3080.          ^R       ... [ reserved ]
  3081.          ^S       ... Used for XON/XOFF.  Never use this.
  3082.          ^T       ... [ reserved ]
  3083.          ^U       ... [ reserved ]
  3084.          ^V       ... [ reserved ]
  3085.          ^W       ... [ reserved ]
  3086.          ^X       ... [ reserved ]
  3087.          ^Y       ... [ reserved ]
  3088.          ^Z       ... MsDOS end of file marker.  Never use this.
  3089.           
  3090.           
  3091.                   DATA DISPLAY -----------------------------------------------
  3092.  
  3093.                   NOTE: Both command characters in this section are
  3094.                         CONTROL characters.  The `^' symbol means `control.'
  3095.                         For example, `^F' represents CONTROL-F.
  3096.  
  3097.          ^F^A     ... quote of the moment
  3098.          ^F^B     ... user's name
  3099.          ^F^C     ... user's city/state
  3100.          ^F^D     ... current date
  3101.          ^F^E     ... total number of calls user has made to system
  3102.                       expressed as an ORDINAL number (eg. `1st', `2d', etc)
  3103.          ^F^F     ... user's first name
  3104.          ^F^G     ... dramatic one-second pause
  3105.          ^F^K     ... total minutes on-line in the last 24-hours,
  3106.                       including the time for the current call
  3107.          ^F^L     ... length of the current call so far (in minutes)
  3108.          ^F^N     ... control-niel (disconnect)
  3109.          ^F^O     ... number of minutes remaining for this call
  3110.          ^F^P     ... written-out date/time when the user has to be
  3111.                       off the system.  NOTE: This uses a built-in Lattice-C
  3112.                       routine which appends the line with a <CR/LF>.  You
  3113.  
  3114.                              OPUS Sysop Manual - Page 47
  3115.  
  3116.  
  3117.  
  3118.  
  3119.  
  3120.                       should consider using ^F^P at the END of a line with
  3121.                       no punctuation ... until Prof.Norton and I can get in
  3122.                       and change a couple of things.
  3123.          ^F^Q     ... number of calls to system to date (ORDINAL NUMBER)
  3124.          ^F^R     ... NET downloads today (download minus upload)
  3125.                       If uploads are greater than downloads, this number
  3126.                       will be negative.
  3127.          ^F^T     ... current time
  3128.          ^F^U     ... on a questionnaire, all answers are required
  3129.          ^F^V     ... on a questionnaire, all answers are optional
  3130.          ^F^W     ... total user uploads
  3131.          ^F^X     ... total user downloads
  3132.          ^F^Y     ... upload:download ratio
  3133.  
  3134.  
  3135.  
  3136.                   QUESTIONAIRES, SURVEYS, ORDER FORMS ------------------------
  3137.  
  3138.                   NOTE: The second character of the commands in this section
  3139.                         is a REGULAR ("printable") character ... NOT a
  3140.                         control character.
  3141.  
  3142.                   HINT: Calm down a little, there are samples at the end
  3143.                         of this file.
  3144.  
  3145.          ^OMd     ... store the last `^OR' response to the answer file.
  3146.                       (See `^OR' below).  `d' is is a description of the
  3147.                       item which is NOT displayed.  The description is
  3148.                       stored in the answer file.  Also, see the examples
  3149.                       at the end of this file for more information.
  3150.          ^ONd     ... let the user type a line and store it in the user
  3151.                       file.  This roughly corresponds to the Fido<tm> "/"
  3152.                       command in questionaires.  `d' is for a description
  3153.                       of the entry in the answer file.
  3154.          ^OOf     ... open an answer file. `F' is a fully-qualified file 
  3155.                       name including path, node, and extemsion.
  3156.          ^OP      ... post user information to the answer file
  3157.  
  3158.  
  3159.  
  3160.  
  3161.  
  3162.  
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.  
  3169.  
  3170.  
  3171.  
  3172.  
  3173.                              OPUS Sysop Manual - Page 48
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.                   FLOW AND USER INTERACTION  ----------------------------------  
  3180.  
  3181.  
  3182.                   NOTE: The second character of the commands in this section
  3183.                         is a REGULAR ("printable") character ... NOT a
  3184.                         control character.
  3185.  
  3186.                         "Remember-- no matter where you go, there you are."
  3187.                                                           --Buckaroo Banzai
  3188.  
  3189.          ^OCp     ... call MsDOS with the command "p".  This is an
  3190.                       embedded "O)utside" command.  "P" is some command,
  3191.                       possibly the name of a program or batch file.  It
  3192.                       is sent to MsDOS (via Command.Com) without 
  3193.                       modification.
  3194.          ^OFb     ... "On exit".  Declare the name of a GBS/BBS file to
  3195.                       be transmitted if, for any reason, the current file
  3196.                       is terminated.
  3197.          ^OQ      ... quit the file immediately
  3198.          ^ORv     ... read menu. `V' is a sequence of characters ... a list
  3199.                       of the valid responses.  Opus considers all of the
  3200.                       characters between the `R' and the first character
  3201.                       less than or equal to the space character to be part of
  3202.                       the list.  In other words, you terminate the list with
  3203.                       a space, tab, end of line, or any other control char-
  3204.                       acter.  Refer to an "ASCII CHART" for help in finding
  3205.                       what characters are "below" the space.  Opus takes care
  3206.                       of upper/lowercase conversion for you.  It is your
  3207.                       responsibility to handle any user prompts: there is no
  3208.                       display associated with this command.  "Command
  3209.                       stacking" is fully supported.  If the user types an
  3210.                       unrecognized character, Opus will ask him/her to try
  3211.                       again.
  3212.          ^OS      ... show another file.  The REST of the current line is
  3213.                       considered the name of a BBS/GBS file.  Do *not* 
  3214.                       include the file's extension.  You can include a
  3215.                       drive and path.  Most settings (eg Color, Auto-More)
  3216.                       are maintained across file boundries.  If the file
  3217.                       you specify doesn't exist, the entire display sequence
  3218.                       is ended and the user is returned to Opus.
  3219.          ^OT      ... top of file (dangerous: can produce an "endless loop")
  3220.                       Useful only for handling "fall-through" menu situations
  3221.                       and (with ^B set) for handling niels.  (ah-hem)
  3222.          ^OUc     ... user response.  "C" is a single character.  It is the
  3223.                       way to process information from the read menu (^OR)
  3224.                       command.  If the user's most recent respons was not
  3225.                       the value you give for `c', the REST OF THE CURRENT
  3226.                       LINE is ignored.
  3227.  
  3228.  
  3229.  
  3230.  
  3231.  
  3232.                              OPUS Sysop Manual - Page 49
  3233.  
  3234.  
  3235.  
  3236.  
  3237.  
  3238.                   PRIV CONTROL -----------------------------------------------
  3239.  
  3240.                   NOTE: The second character of the commands in this section
  3241.                         is a REGULAR ("printable") character ... NOT a
  3242.                         control character.
  3243.  
  3244.  
  3245.                   Dealing with the rest of the file...
  3246.  
  3247.          ^PD      ... Below Disgraced don't see rest of file
  3248.          ^PN      ... Below Normal don't see rest of file
  3249.          ^PP      ... Below Privil (or Privel) don't see rest of file
  3250.          ^PE      ... Below Extra don't see rest of file
  3251.          ^PA      ... Below Assistant sysop don't see rest of file
  3252.          ^PS      ... Below Sysop don't see rest of file
  3253.  
  3254.  
  3255.                   Commands dealing with the rest of the current line...
  3256.  
  3257.          ^PLD     ... Below Disgraced don't see rest of line
  3258.          ^PLN     ... Below Normal don't see rest of line
  3259.          ^PLP     ... Below Privil (or Privel) don't see rest of line
  3260.          ^PLE     ... Below Extra don't see rest of line
  3261.          ^PLA     ... Below Assistant sysop don't see rest of line
  3262.          ^PLS     ... Below Sysop don't see rest of line
  3263.  
  3264.  
  3265.  
  3266.                   FIDO<tm> COMPATIBLE QUESTIONAIRE COMMANDS ------------------
  3267.  
  3268.                       Important:  All of the functionality in the following
  3269.                       ---------   commands is available with ^O commands.
  3270.                                   None of the following are guaranteed 
  3271.                                   beyond Opus Version Zero.  Except for
  3272.                                   some unusual circumstance, you should use
  3273.                                   the ^O commands instead of these.
  3274.  
  3275.          +nt      ... column one only.  Signals a multiple choice answer.
  3276.                       The `n' is actually a digit.  EXAMPLE: `+3' would
  3277.                       accept 1, 2, or 3 as an answer.  'T' is normal text.
  3278.                       Opus will ask for the answer after the line of
  3279.                       text is displayed.  The digit is
  3280.  
  3281.          /t       ... column one only. 'T' is normal text.  After displaying
  3282.                       and text, Opus will wait for the user to type some
  3283.                       sort of character data.  The answer is stored in
  3284.                       the answer file.
  3285.  
  3286.          !        ... column one only.  If in the most recent multiple
  3287.                       choice question (see `+'), the user picked the highest
  3288.                       option (eg. `3' above), the questionaire will 
  3289.                       terminate immediately.
  3290.  
  3291.                              OPUS Sysop Manual - Page 50
  3292.  
  3293.  
  3294.  
  3295.  
  3296.  
  3297.  
  3298.          *        ... column one only.  Put some user info (eg.name) into
  3299.                       the answer file.
  3300.          
  3301.          ?t       ... column one only.  'T' is normal text which is not
  3302.                       transmitted.  Instead, it is stored in the answer
  3303.                       file.  This command is a Fido<tm> enhancement.  It
  3304.                       is not guaranteed beyond Opus Version Zero.  You
  3305.                       should try to use a ^O command instead.
  3306.  
  3307.                       Example:
  3308.                                     Question file:
  3309.                                              ?NAME
  3310.                                              /What is your name?
  3311.                                     Answer file:
  3312.                                              NAME Mark Twain
  3313.  
  3314.  
  3315.  
  3316.                   FOR FILES.BBS ONLY (Fido<tm> compatibility) ----------------
  3317.  
  3318.          @        ... in column one, stops display for those under
  3319.                       AsstSysop.  This is for Fido<tm> compatibility only.
  3320.                       You should not count on this remaining after
  3321.                       Version Zero.  Use a ^P command instead.
  3322.  
  3323.          -        ... column one only.  turns on WHITE.  The display will
  3324.                   remain white until the next file name.
  3325.  
  3326.          NOTE: There are several ^F commands that deal with the amount
  3327.                of time a user has remaining.  Until the user is totally
  3328.                through the logon procedure, he/she will have about 10
  3329.                minutes.  The use of these commands prior to the first
  3330.                MAIN MENU may produce unexpected results.
  3331.  
  3332.  
  3333.  
  3334. EXAMPLE 1
  3335.  
  3336. CONTENTS OF THE EXAMPLE 1 FILE:
  3337.  
  3338.                  Please select one of these:
  3339.                     H)elp on using the system
  3340.                     T)rojan horse program alert
  3341.                     E)quipment used on-line
  3342.                     Q)uit
  3343.  
  3344.                  Select: ^ORhteq
  3345.                  ^L
  3346.                  ^OUh^OSc:\opus\morehelp
  3347.                  ^OUt^OSc:\opus\trojans
  3348.                  ^OUq^Oq
  3349.  
  3350.                              OPUS Sysop Manual - Page 51
  3351.  
  3352.  
  3353.  
  3354.  
  3355.  
  3356.  
  3357.                  We use an AT computer with a 30 meg Seagate disk drive.
  3358.                  The modem is a USR Courier 2400.  There is 640k system
  3359.                  memory with 3 megabytes of extended memory which is used
  3360.                  as a RAM disk.
  3361.  
  3362.                  ^OT
  3363.  
  3364.  
  3365.  
  3366. NOTES FOR EXAMPLE 1:
  3367.  
  3368. A short menu system for multiple bulletins.  First the menu is displayed.
  3369. Then, after "Select: ", Opus will wait for the caller to type `H', `T', 
  3370. or `A'.  For aesthetics, we clear the screen after the menu response (^L).
  3371. Then.... if the caller typed `H', we will display the file MOREHELP.  If
  3372. it's `T', the caller will see TROJANS.  If the caller typed `Q', we will
  3373. exit the file display and return to Opus.  The only unaccounted-for menu
  3374. response is `E' ... which is taken care of by the material at the end.
  3375. In other words, if the user gets to the part beginning with "We use an...",
  3376. he/she must have typed an `E'.  It's the "fall-through" case here.  Because
  3377. Opus doesn't have to change to another file, the fall-through will always
  3378. be the quickest.  Finally, at the end of the file, we tell Opus to recycle
  3379. and display the menu again (^OT).
  3380.  
  3381.  
  3382.  
  3383. EXAMPLE 2
  3384.  
  3385. CONTENTS OF THE EXAMPLE 2 FILE:
  3386.  
  3387.          Welcome to the board, ^F^B.
  3388.          ^OOc:\opus\newusers.txt
  3389.          ^OP
  3390.  
  3391.          What is your occupation? ^ONoccupation
  3392.  
  3393.          Please find your favorite color ...
  3394.  
  3395.                   B)lue    R)ed     M)agenta
  3396.                   L)ilac   Y)ellow  P)uce
  3397.  
  3398.          Type the first letter of your choice: ^ORbrmlyp
  3399.          ^OMchoice
  3400.          ^OUbBlue! really? Wow, that's my favorite color, too!
  3401.  
  3402.          Thanks for taking the time to fill out this questionaire.
  3403.  
  3404.  
  3405. NOTES FOR EXAMPLE 2:
  3406.  
  3407. A short survey.  First we do a welcome that includes the user's name (^F^B).
  3408.  
  3409.                              OPUS Sysop Manual - Page 52
  3410.  
  3411.  
  3412.  
  3413.  
  3414.  
  3415. Then we setup an answer file called C:\OPUS\NEWUSERS.TXT.  Any responses
  3416. will be put into this file.  Note that the answer file stays open across
  3417. files ... should you swap files using ^OS.  The first item we put into the
  3418. answer file is the user's name (^OP).  It is NOT ever necessary to ask a
  3419. user "What is your name"... not even a new user.  It is easier on the system
  3420. and the caller to use the ^OP command rather than being redundant.
  3421.  
  3422. The first question deals with the user's occupation.  The display would
  3423. look like this:
  3424.  
  3425.                   What is your occupation? _
  3426.  
  3427. Whether an answer is required depends on whether you have used the ^F^U 
  3428. or ^F^V commands.
  3429.  
  3430. If the caller typed "accountant" then your answer file would contain
  3431. this line:
  3432.  
  3433.  
  3434.                   occupation: accountant
  3435.  
  3436. The description "occupation" was part of the ^ON command itself.
  3437.  
  3438. The next piece of business is a multiple choice question.  It works exactly
  3439. like the MENU in example #1 above.  The addition is `^OMchoice' to store
  3440. the user's response in the answer file.  For example, if the user selected
  3441. RED, the answer file would look like this:
  3442.  
  3443.                   choice: R
  3444.  
  3445. Note that if the caller likes BLUE, Opus will get all excited.  See the
  3446. `^OU' statement.  We use this line for two reasons: (1)to show that you
  3447. can get exceedingly (excrutiatingly) clever; and (2)you can combine almost
  3448. any ^O command.
  3449.  
  3450. You can have more than one answer file.  Every time you use ^OO, the 
  3451. current answer file is closed and the new one opened or created.  One 
  3452. side effect involves opening the same file... not advised for normal
  3453. operation... but that is one way to force Opus to physically write to
  3454. disk any responses it has buffered.
  3455.  
  3456.  
  3457.  
  3458.  
  3459.  
  3460.  
  3461.  
  3462.  
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.                              OPUS Sysop Manual - Page 53
  3469.  
  3470.  
  3471.  
  3472.  
  3473.  
  3474. For More information on OPUS
  3475.  
  3476. There are  two ways  to find  out more  about the  way OPUS works and to get
  3477. questions aswered. If you are having problems with OPUS, contact  one of the
  3478. InfoNodes. They can be reached at:
  3479.  
  3480.                OPUSinfo Here     modem (214) 991-3381 1/113
  3481.                OPUSinfo There    modem (415) 753-3356 1/114
  3482.  
  3483. This is for questions involving specific problems. They can give you answers
  3484. to some of the most commonly asked questions.
  3485.  
  3486. For general  discussions  about  the  usage  of  OPUS,  you  should consider
  3487. subscribing  to  the  OPUS  sysop  EchoMail  area, called MEADOW. Any of the
  3488. distribution nodes can refer you to  a tie-in  point for  this area.  If all
  3489. else  fails,  contact  Jon  Sabol  at  124/210 for information pertaining to
  3490. MEADOW EchoMail connections.
  3491.  
  3492. MEADOW carries the same  copyright as  OPUS. You  are required  to act  in a
  3493. friendly and  lawful manner if you participate. We are trying desperately to
  3494. keep a casual and constructive atmosphere in the OPUS area.  If that  is not
  3495. your  intent,  please  do  not  subscribe  to the conference. If you wish to
  3496. discuss technical aspects of the programs, you are wholeheartedly welcome to
  3497. join!!!
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.  
  3523.  
  3524.  
  3525.  
  3526.  
  3527.                              OPUS Sysop Manual - Page 54
  3528.